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USER'S MANUAL STATEMENT 

"This equipment generates and uses radio frequency energy and if not 
installed and used properly, that is, in strict accordance with the 
manufacturer's instructions, may cause interference to radio end 
television reception. It hes been type tested and found to comply v/ith 
the limits for a Class B computing device in accordance with the 
specif icMJons in Subpart J of Part 15 of FCC rules, which sr^ desisned 
to provide reasonable protection against such interference in a 
residential installation. However, there is no guarantee that 
interference will not occur in a particular instaliation. If this equipment 
does cause interference to radio or television reception, which can be 
dcternriined by turning the equipment off and on, the user is 
encouraged to try to correct the interference by one or more of the 
following measures: 

— reorient the receiving antenna 

— relocate the computer with respect to the receiver 

— move the computer away from the receiver 

— plug the computer into a different outiet so that computer and 
receiver are on different branch circuits. 

"If necessary, the user should consult the dealer or an experienced 
radio/television technician for additional sussestions. The user may 
find the foilowinj booklet prepared by the Federal Communications 
Commission heipfui: 'How to identify and Resolve Radio-TV 
Interference Problems.' This booklet is available from the U.S. 
Government Printins Office, Washinston, D.C. 20402, Stocl< No. 
004-000-00345-4, ■ 
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production, the COMMODORE 64 allows you to connect your oudio out- 
put to almost ony high-quafity ampiificaticn system. 

While we're on tVie subject of connecting tSe COMMODORE 64 to 
other 3iece^ of equipment , , , your system can bs expandad b/ adding 
accessories, kno\vn as peripherals, as your corripu'lrig needs yrow. 
Some of your options irciude items like o DAIASSETTE* recsrde' or as 
many as 5, VIC 1 541 disk drive storage units for the programs you make 
and/or plci^. If you already haVQ a \/\C 1540 disk drive yojr dealer can 
update 't -^or use with the COMMODORE 64. Vou con odd a VIC dot 
matrix printer to give you printed copies of your programs, letters, in- 
voices, etc. . . If you v/ait to connect up with larger ccmputers and their 
massive data bases then just plug in a VICMODEM cartridge, and get 
the services of hundreds of specralists and a variety of informotion net- 
works through /our home or business telephone. Finally if you're one of 
those people interested in the wide variety of applications softv/are 
available in CP/M**, *he COMMODOItE 64 can be fitted with a plug-in 

Z-80 microprocessor. 

Just as important as all the available hardvvare is the fact that this 
USER'S GUIDE v/ill help you develop your understanding of computers. 
It won't "ell you everything there is to know cbout camputers, but it will 
refer you to a v^ide variety of publications for more detailed information 
about the topics presented. Commodore Wi'onts you to really enjoy your 
nev./ COMMODORE 64. And to have fun, rernernber: proyrcjrnrTiiny is 
rot the kind of thing you can lean in a doy. Be patient with yourself as 
you go through the USER'S GUIDE. But before you start, take a few 
minutes "O fill out and mail in the owner/registrotion cord thnt cnme jvith 
your computer. It will ensure that ycur COMMODORE 64 is properly 
registered with Commodore Headquarters and that you receive the most 
up-to-date information regarding 'uture enhancements for your ma- 
chine. Welcome to a whole new world of funll 

NOTE: 

Mony programs are under developmert while thi.= mnniinl is being 
produced. Please check v/ith your local Commodore dealer and v/ith 
Commodore User's Aflagaiines anc Clubs, which will keep you up to 
date on the wealth of opplicotions programs being writter for the 
Commodore ^4, vi/cirldwida. 



*DATAS3fTTE \s a registered trademark of CcmmodnrB Business Wachines, Inc. 
*■■ CP/ftV Is o regiiTered troderrorfe of 3lgtral Research In. Spseificotions subject to 
elnarge. 
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INTRODUCTION 

Congratulations, on your purchase of one af the best computers in the 
world. You are row t-he proud owner of the COMMODORE 64. Com- 
rr.odore is known as The firiendly Computer compciny, and port of 
b&ing friendly is giving you easy tc read, easy to use and easy to 
understond instruction manuals. The COMMODORE 64 USER'S GUIDE is 
designed to give yau all the information you need to properly set up your 
equipment, ge* acquatrted with operci'lng the COMMODORE 44, and 
give you a simple, fun start a' learning to make your own programs. 

For those of you who don't want to bother learning how to program, 
we've put oil thi? infornnatiori you need to use Commodore programs O'- 
other prepackaged programs and/or game cartridges (third party 
software) right up front. Thii means you don't have to hunt throjgh -he 
entire boot to get started. 

Now let's look at some of the exciting features that are just waiting for 
you inside your COMMODORE M. First, when it comes to grnphir.i; 
you've cot the mosi tidi/anced picture maker in the nnicrocomputer in- 
dustry. We call i- SPRITE GRAPHICS, and it allovi/s you lo design your 
own pictures in 4 different colors, just like the ones you see on arcode 
type video games. Not only that, the SPRITE EDITOR let's you animate as 
many us 8 different picture levels at one time. The SPRITE EDITOR will 

soori be available as □ software program that you can load directly into 
yaur COMMODORE 64. You can move your creations any\A'here on the 
screen, even pas« one image in front of nr behind another. Your COM- 
MODORE 64 even provides automatic collision detection which instructs 
the computer to take the action you want when the sprites hit each 
other. 

Next, the COMMODORE 64 hos built-in musir and sound effects that 
rival many well known music syntheaiEers. Tl-ig part of your computer 
gives you 3 independent voices, each with a full 9 octave "piano-type" 
range. In addition you get 4 different waveforms (sawtooth, triongle, 
variable puUe, ond noise), □ programmable ADSR (attock, decay, sus- 
tain, release) envelope generator and a programmablo high, low, ond 
bandpass filter for the voices, and variable resonance and volume con- 
trols. If you wart your music to play back with professional sourd re- 



U^PACK^NG AND CONNECTrNG THE 
CO/VIMODORE 64 

The follouving step-by-step instructions shovi/ you how to connect the 
Commodore 64 to yojr television set, sound sysleiri, or monitor and 
mcike sure ever/thing is working properly. 

Before attaching anything to the computer, check the contents of the 
CommoHore 64 container. Besides this monjct!, you should find the fol- 
lowing items ^ 

1 . Commodore 64 

2. Power supply (black box with an AC plug and supply cord) 

3. Video cable 

4. TV Switchbox (snrtall silver box with short antenna leads). 

If any items are missing check back with your dealer mmed ately for 
a replacement. 

Firat, let's take a look ot the arrangement of the various connections 
on the compute' and how eoch functions. 

SIDE I^NEl CONNECTIONS 

1 Power Socket. The free end of the cable from the power supply rs 
nttciched here to supply power to the Commodore 64. 

2. Power Switch, Turns on power 'o the Commodgre 64 , 

3. Game Ports. Each game connector can accept □ joystick or ganne 
controller poddle, while the lightpen con only be plugged into the 
game port closest to the front of your computar. 

REAR CONNECTIONS 

4. Cctrlridge Slot. The rectangular slot to the left accept^ progrom or 
game cartridges. 

5. Channel Selector. Use tMs switch to select which TV channel the 
computer's picture will be displayed on. 

6. TV Connector, This connector supplies both the picture and sound 1o 

vour television set. 

7. Audio & Video Output. This connector supplies direct audio, which 

can be connected to a high quality sound system, and a "compos- 
ite" video signal, which con be fed into a television "monrtor." 

8. Serial Port. You con attach a printer or single disk drive directly to 
the Commodore 64 through this connector. 
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9. Cassette Interface. A DATASSETTE reccsrder can be attached 1o the 
computer 3& you can save informatior entared for use at a Icter 
time. 

10. User Port. Vorioji interface cartridges can be attached to the user 
port, 5iirh cs the VICMODEAfl, or RS 232 cnmmuniration rnrtndge. 



INSTALLATION 

CONNECTIONS TO TOUR TV 



Connect the computer to your TV cis shovun on page 4. 

1 . Attach one snd of the TV cable to the phono Type TV signol jack at 
the rear of the Commodore 64. Just push It In. Either end of the 
cable can be used. 

2, Coinect the other end of the cabie to The antenna switchboK. JusT 
push it in. 
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3. If you have a VHF antenna,, disconnect it from /our TV set. 

4. Connect your VHF anterna cable tc the acrew terminals labeled "an- 
tenna input" on the switchbox, If your cintema cable is the round 
75 ohm coax type, use a 75-cihm to 300-ohm adapter (ngl supplied) 
to attach your antenna cable ro the switchbox. 

5. Connect the twin lead output cable of the ontenno switchbox to the 
VHF ontenno terminals of your TV set. If your set is one of the new^r 
types with a round 75 ohm VHF connector, you will need a 300-ohm 
to 75-ohm converter (not supplied) to connect the switchbox ro the 
75-ohm VHF antenna inpyt on the set. 

6. Set the TV's VHF tuner to the channel number indicated on "he com- 
puter's channel selector switch (channel 3 move the switch to the left, 
channel 4 move the switch to the right). If a strong local TV signal is 
present on one of these chcnnels, select the other channel to avoid 
possible interference. 

8, plug the power supply cable into the power socket on the side of the 
Connrriodore 64. Just push if In. It is "keyed" to allow nsertion in only 
one direction, so you can't connect the power cord tne wrong way. 
The power supply converts household currant into the form the com- 
pjter uses. 




YOiJR 75 OHM 
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The Commodore 64 h now correctly connected. IMo ndditionol con- 
nections ars required to use the computer with your TV. The antenna 
swiiclibox will connect the compuier re the TV when The slide svi/ifch is in 
the "computer" posiTion, When the switch is in the "TV" position your set 
will operate normally. 
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OPTIONAL CONNECTIONS 



Since the CommDdore 64 furnishes c channel of high fidelity sound, 
you nay wish to play it through a quality amplfier to realize the best 
sound possible, in addition, the Comirodore ii4 dso provides a stan- 
dard "cornposlte" video signal, which can be fed into a television 
monhor. 

These options ore mode poss his Wy the ouHin/viHon mitpiif ]nrk on 
tlie rear panel uf the Commodore 64. Tne easiest way to gain access to 
these signals is by ujing a standard 5-Pin DIN audio cable (rot 
supplied). This cable connects directly to the audioyvideo connector on 
the cDrnputei-. Two oF the fsur pins on the opposite end of the cable 
cotitair the audio ond video signals. Optionally, ycu can cons'ruct your 
OV^n coDle, us ng the pinouts shown in f\ppsnd\x I as a guide. 



Normally, the BLACK connector of -he DIN cable supplies the AUDIO 
signal. This plug may be connec'-ed to the AUXILIARY input of an am- 
plifier, or the AUDIO IN connector of a monitor or o'her video sysfem, 
such OS a i/ideo cassette recorder (VCR). 

The WHITE or RED connector usually supplies the direct VlOtO signal. 
This pljg is connected to the VIDEO IM conrrector of the monitor or video 
input section of some other video system, such as a VCR. 

Depanding on the mcinufcicturer sf your DfN! cable, fhe color coding 
of the plugs T^ay be different. Use the pinouts shown in Appendij< I to 

match up the proper plugs if you don't ge* on audio or video sigral 
using the suggestsd connections. 
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AUaiO SYSTEM 



If ycu purchased peripheral equipment, such as c VIC 1541 disk drive 
or a VIC 1515 printer, you may v/ish to connect it ot this 1im«. Refsr to 
the user's manuals supplied with any additional equipment for the 
proper procedure for connecting it to the computer. 



A completed system might look like this. 




OPERATION 



USING THE COMMODORE 64 



1 . Turn on fhe computer using the rocker switch on the right-side panel 
when you're looking at the computer from the front. 

2. After a few moments the following will be dijsplayed t>n the TV 
screen: 




3, If your TV has a manual fine runing knob, odjusT The TV until yoj get 
o clear picture. 

4, you rnay also want to odjust the color and tint controls on the TV for 
the best display. You can use the col^r odjustmen- procedure dc 
scnbed later to get everything setup properly. When you first get o 
picturej the screen should appear mostly dork blue, with a light 
blue border and letters. 



If you don't get the sxperled results, rechecic the cables ond connec- 
tions. The accompanying chart will help you isolate any problem. 



TROUBLESHOOTING CHART 



Symptom 


Cause 


R&medy 


Indicator Light 

not "On" 


Computer rot 
"Oi" 


Moke sure power 
switch is in "On" 
posrion 




^owcr cable 
not plugged 

in 


Ch&ck paw9r socket 
for loo&e ar d(5- 
connected po\^^&r 
cable. 




Power supply 
not plugged 


Check connection 
with wall tjutlfet 




Bdd fyse in 

■rorrpjter 


Tqice aysTem To 
authorized dealer 
fcr replacement of 
tuse 




TV or wrong 
channel 


Check other 
ciiannel for 

pirturft (3 or 4) 




Incorrect 
hockup 


Cornputsr hooks up to 

VHF ontenna terminals 




^ideo cabU 
net plugged 

in 


Chack TV output 
cable connection 




Computer set 
for wrong 

channel 


Set coimpjter for 
same channel as TV 
(3 or 4) 



Symptonn 


CouM 


Remedy 


Rondom paMern 


Cartridge not 


Reinsert 


on TV with 


properly 


co-tridge after 


cartridge in 


inserted 


tunning off pow^r 


place 

Picture (with out 


Poorly tuned 




Reture TV 


color 


TV 




Pic+ur* wifh 


Bad color 


Adjust c^lorj/ 


poor cclo^ 


odjustment 


hiuWbrtghtnes* 




on TV 


cor>trflla on TV 


Sound witfi 


TV volume up 


Adjust valume ot 


excess 


high 


TV 


background 






noise 






Picture OK, 


TV voitjmft loo 


Adjust vslume of 


but no sound 


low 


TV 




Aux. output 


Connect sound 




nit properly 


jack to au>. input 




conneclod 


Of* amplifier and 
select oux. inpLO 



TIP; Tlie COMMODORl 6^ was designed to be UJed by everyore. 
But we ot Comrrodore recognize that compjter users may, occosionally, run into 
difficulties. To help onswer your questions and give you some fun programmirg 
ideas, Comnodore has created several publications tc help you. Tot might olso find 
that its a good idea to join a Commodore Users Club to help you meet some other 
COMMODORE H Oivners who con help you gcir knowledge and experience. 



CURSOR 

The flashing squa'e under READY is called the cursor and indicates 
where what you fyp9 on ths <eyb.3cird wuKI be di<ipi(iyed on the screen. 
As you type, the cursor will iTove ahead one space, as the original 
cu'sor position is replaced with the character you tyiped. Tr^' ^/ping on 
the keyboard and watch as characters you type are displayed en the TV 
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COLOR ADJUSTMENT 



There is a simple way to get a panern of colors on the TV so you can 
easily adiust the set. Even though you mdy not be famifiar with the 
operation of the computer right ioia/, just follovu along, and you'l see 
hov^ evi5y H is tc vse the Commodore 64. 

Frst, look on the left side of the keyboard and locate the key marked 
IJBM .This stand; for ConTRoL and is used, in conjunction with other 
keys, to instruct the computer to do a specitic tnsk. 



-.-.->,.,.. ,....J.,L,JJi 



WHT nm cvN FtiR am blu 



en BQ 



HUN junior 






i SS Dd 



C V 1 



□ CD CS BQ 



sm £iii?i QH 



To use a comroi funclion, vuu hold down the^^H'^^'*' while dcprc:s- 
ing a second key. ^^^ 

Try this; held the HD ''SV while also depressing theflkey. Then re- 
lease both keys. Notning obvious should hove hopoened, but \\ you 
tcuch any key row, the screen will shcjw ihe chcracter displayed in re- 
verse lype, rather than nornndl type — like the opening message or any- 
thing you typed earlier. 

Hold down the ^^^^ , What hopperis? If you did the above pro- 
cedure correctly, you should see a I'ght blue bar rnove utruss ihe screen 
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ancf then move down to the next line as long os the 
presied. 



IHS ii de- 




Nos/^V ho'd i^^^gj vv'hile depressing any of t^ie o+^^Cf ny mbcr keys . Each 
cjf fhern has a color marked or The front. Arything displayed from this 
point will be in that color. For example., hold HIW and theQkey and 
release bolh. Nov/ hold the ^^^^Q , 

Watch the displcay. The bar is now in ycllov/! In a like manner you can 
s-hanye ifie bar to any of The other colors incicated or the njniber keys 
by holding ^^Q and the appropriate key. 

Change the ba- to a few more different colors and then cidjii«;t the 
color and tint controls on your TV do the dioplciy motcies the colors you 

selected. 

The display should appear something like this: 




At this point everything Is properly cidju&Tiiid and workijiy toueully. 
The following chapters will introduce you to the BASIC language. How- 
ever,, you can immediately star) using some of the mony prewritten ap- 
plications and games available for the Commodore 64 without knowirvg 
anything about comouter programming. 

Fdch ot these packages contains detailed inforrration about how to 
js« the progrom. It is suggested, though, that you read through the first 
■few chapters of this manual to become more familiar with the basic 
operation of your new system. 
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KEYBOARD 

Now lhat you've got everything $et up and adjusted, pleose take a 
■few morreritB to familicrrize yourself with tha ks/boord whic^1 is your- 
(nusi Imparlurit rneuns o( corrrrunication with the Commodore 64. 

You will find the keyboard similar to a standard typewriter keyboard 
found ii most areas. There are, however, a number of new keys which 

control specialized fLinctions. Whcit fol ou(s Is a brief description of the 
various keys ond iiow they funclfori. The detuiled operaition of each key 
will be covered in Inter sections. 




The ^^^^B key signals the computer to (ook at the infornnation thot 
yoL typed and enters that information into memory. 



The B!!!H key works like tha* on a standard typewriter. Mony keys 
are capatie of disploying two letters or Eymboit Cind W/o graphic char- 
deters. In the "upper/lower case" mode the ^^Q key gives you star- 
dord upper case chorocters. In the "upper case/graphic" mode the 
^^Q ksy vi/ill display the graphic character on the right hand side of 

the front part of the key. 

In the case of special YELLOW function keys, the ^^Q key will give 
you The function marked on the front of the key. 
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EDITING 

No one is perfect, and the Commodore 64 fakes that into accoyrit, A 
number of edifing keys let you correct fyping mistakes and move intor- 
mation around on the screen. 



Thor^ are tv/Q k^ys mork^d ^^^ (CuRSoR), one ^^ith up and dovvn 

arrows {j^^^| ,The other with left and right arrov.'s ^^^^g . Yoj can 
use these ke/s to move the cursor up ond down or left and right. In the 
unshifted mode, the |!li£JJ keys will let yoL move the cursor down and to 

the right". Usmg rhe ^^^Q key and ^^^^ keys allci^A's the curs^jr to be 
moved either up or to the left. The cursor keys hove a special repeat 
feature that keeps the cursor movmg until you release tine key. 



If yoii liit the ^^^^^J key, the cursor wHI nnove back a spare, farai- 
ing (DELeling) the previous character you typed. If you're in the micdle 
of a line, the character to the left is deleted and the characters to the 
right automatically move together to close up the space. 

A ^^^3ed ^^^^J allows you to INSerT information on a Ifne. For 
example, if you noticed a typing mistake in the beginning of a line — 
perhaps yo^J left out parr of a name — you could use the ^^^^Q kev to 
move back to the error ond then hit r^BHl to insert a space. Then 
just iVpe ii *he missing letter. 



positions the cursor at the "HOME" pos tion oi the screen, 
v/hich is the upper left-hard corner. A shifted BUrHTOH will clear the 
screen and placs the cursor in the home position. 



^^9 operates as the name implies. It restores the computer to the 
normal state it WdS in before you changed things with a program or 
some comrriard, A lot more will be scid ori this in loter chupters. 

\S 



FUNCTION KEYS 

The four fundion keys on the right side of the keyboard can be "pro- 
grammed" to hordle a vdriety of functions. They can be dtrfiiied in 
many ways tc handle repetitive tasks. 




The |jy;g key, which sTondsfo' ConTRoL, allows you "o set colors, and 
perform other specia'ized functions. Yoy hold the ^^^I'^^Y down while 
depressing another designated key to get a control fLnction. Ysu had an 
opportunity to try the ^^M key when you changed text colors to create 

different color bars curing the setup procedure. 



Normally, depressing the ^^^^^ key will stop the execution of a 
BASIC program. It signals the computer to STOP doing something. Using 



16 



the isjjyiiUiy key in the shif-ed mode wil. cllow yoj to automatically 
load o program fron tape. 
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COMMODORE KEY 



The Commodore key Q performs o nurnber of funcrions. First, it 
aUows you ho move between the text and graphic display modes. 

When the rnmputer is first turned on, it is in the LJppef Crise'/Graphic 
mode, that is, everything you type is in upper cose letters. As was men- 
tioned, usiny ihe ^^^ key in this mode will displuy the yraphic en the 
right side ot the keys. 

If you hold down the Q key and BHISl key, the display will change 
to upper ard lo\A/er cose. Now, i''" you hold do^A^n the [« cey and any 
otheJ" key wit!" ci graphic symbol, the graphic showrn on the left side of 
the key will be displayed. 

To get back into the upper case/graphic mode hold down tne Q <ey 
find ^^^n key ngnin. 

The second function of the [^ key is to allow you access to a second 
set of eight text coors. By holding down the Q ^^y ^"^^ ^'^Y °'^ '^^ 
number keys, ary text now typed will be in the alternate color ava loble 
from the key ycu depressed. Chapter 5 lists the text colors ovolable 
from each key. 



BACK TO NORMAL 

No\A' that you've hod a charce to look ever the keyboard, let's ejtplore 
some of the Cornmodore 6i's many capabilities. 

if /O'J still have the color bars on thg screen from odjusting your TV 
set, hold ^^Q and ^^J2JJ| . Ihe screen should clear and the cursor 
will be positioned in the "nome" spot (upper left-hand corner of the 
screen) 

Now, simultaneously hold l^ ond the ^g key. This seta the text color 
oack to light blue. There Is one rrore step needed to get everyihing back 
to normal. Hold BI3 end O (Zero notOhlj. This sets ihe display mode 
back to nnrmnl. If you remennber, we turned REVERSE tysf* on with the 
^S^l^l to create the color bctra (the color bora v/ere actually reversed 
spaces). If we were in the normal text mode during the ccior test, the 
cursor would have moved, but just left blank spoces. 
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TIP: 



Now that you've done ihings the hofd v^ay, fbere is a simple wov to reset the 
rtiQchiiie to ths nonnal display. First press the flBBH^ kev and then prest 

the |3^^3 tey. i:iii;ri--ina must olwoys be held down in order to use the 
^^Eg Iny funrlion. 

Ttis v^'iW clear the icr'ffen and return ever^'thbng To norrnaL If liieitr ■& y pTuyvni in 
the compjter, if will 3# ie-ft vntcychff{;J. Thf? i; g good ^equep'ce to reiT^tmbeF , e:»pt;- 
LiuJI^ i( yji^ Jo y lop oF proyrurrirriSriy. 

H yeu msh o reset "he mochine as if ir were TLrned off and Th*n swfrched on 
ogoin. Type, 5"'Se4759 and preis ■rmiHi'M . 3e carefjl ijsing "his commend It wil 
wipe cut on/ program or irfarmation that is cur.'ently in the compiler. 



LOADING AND SAVING PROGRAMS 

One of the most important -features o^ the Cornmcidor= &A is the ability 
to 3ave and load progranna to end froTi cassetle taDe or disk. 

This capability allows you To save the programs you write for use at a 
later time, or purchase prewrilten programs to use wth the Commodore 
64. 

Moke sure that either the disk drive or datasstte unit is atloched 
properly. 

LOADING PREPACKAGED PROGRAMS 

For those of /oj interested in using only preaackaged programs 
available on cartridges, cassette, or disk here's all you have to do: 

1. CARTRIDGES; The Comrrodore 64 computer has a line of programs 
ond games on cartridge. The programs offer a wide variet/ of business 
and personal applications and the garries are jjst like reel arcade 
game? not imilotions. To locid th^se games, first turn Qn your TV set. 

Next turn OFF your Corrmadore 64. YOU MUST TURN OFF YOUR COM- 
MODORE 64 BEFORE INSERTING OR REMOVING CARTRIDGES OR YOU 
MAY DAMAGE THE CARTRIDGE AND/OR YOUR COMMODORE 641 

Third insert the cartridge. Now turn your Commodore 64 on. Finally type 
the appropriate SI ART key as Is listed on the instruction sheet thai comes 
with each game. 

2. CASSETTES: Use your DAT ASS ETTE recorder aid the ordinary audio cas- 
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setteS that c<:ir1'ie as part of your prepackaged progrom, Make sure 

the Tape is completely rewound to the beginning of tVie first side. 
Then, :ust type LOAD. The computer wil( answer with PRESS PLAY ON 
TAPE, so you respond by pressirg play on your dalasette morhine. Ar 
this point the computer screen v^ill go blark urtil the program is 
fcurd. The computer will say FOUND (PROGRAM NAME) on the 
screen. Now you press down or the H KEY, This will ac-ually 
load the progrcm into the conpuler. If you want to stop the loading 

simply press the ^^^^^ key. 



3. DISK: Using yoLr disk drivft^ carRfully in.'Sert the preprngrammed dislf 
so that the lobel on the disk is fcctog up <aod is elosejt to you, Look 
for a llTtle notch on the disk (it night be covered with a little piece o- 
tape). If you're inserting the cisk properly the notch will be on the left 
side. Once the disk is inside close 'he protective gate by pushing down 
on the lever. Now type LOAD "PROGRAM NAME", 8 and hit The 
key. The disk will make noise and /our screen mill say; 



SEfiRCHING FOR PROGRfltl H«1E 
LOHDING 

REfiOy 



When the READY comes on and the H 1= on, jjst type RUN, and 
your prepaeltaged softjvcire is ready to use. 

LOADING PROGRAMS FROM TAPE 

Looding a program back frcm tape or disk is just as simple. For tape, 
rev^ind the tape back to the beginning and type: 



LORD "PRODRRM HfiME' 



If you don't remember the progrom name, just t^pe LOAD and the 
first program on the tope vM be loaded into memory. 
Af'er you press ^^^^^| the computer will respond \A(ith: 
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Afle( you depress the play key, The screen will blank, turning the 
border color of the screen as the computer jeorches for the progrom. 
iWhein thfs prcigrnm is found, the 5cresn will dlsp'oyi 



FOUND PROGRAM NfiME 



To actually LOAD the p'^ogrorr, depress "he key. To abandon the 
LOADing procadure, hit llTOBSTtia . If you hil the Commodore k^y, the 
screen will again turn the border color while the p'ogram 15 LOADed. 
After the LOADing procedure is completed, the screen will return to the 
normal state and the READY prompt will reappeor. 



LOADING PROGRAMS FROM DISK 

Looding a program from disk follows the same format. Type: 



LORD "PROGRAM HFlME",S 



The 8 is the code for rhe disk, so you're just letting the computer know 
thaf you want the program loooed from the disk. 



After you hit 
shows: 



the disk will start whirring and the display 



SEARCHING FOR PRGGRfiM NfiME 
LOFIDIHQ 

REflDV 
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NOTE: 

Wher you load a new program into the compLrier's memory, any ir- 
structions that were in the ccnnputer previously v/ill be erased. Make 
sure you save a program you're working on before loading a new one. 
Once a program has besn loaded, you can RUN it, LIST it, or maks 
changes and re-sQve the new version. 

SAVING PROGRAMS ON TAPE 

After entering a program, if you wish to save it on tape, type; 



IRVE "PROGRHM HPME 



'PROGRAM NAME" can be up to 16 characters long. After you hit 
rhe computer will respond wfth: 



PRESS PLftV PHD RECORD ON TAPE 



Press both the record and play keys on the datasette. The screen will 
blank, turnirg the color of the border. 

Aft&r the program is ^aved on tape, the READY prompt will rooppcor. 
Indicating that you con start working on another progrann, or just turn 
off the computer for a while. 

SAVING PROGRAMS OM DESK 



Saving 3 progra-n or disk is even simpier. Type: 



SAVE "PROGRFlM HOME" ,8 
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"■"he 8 h the code far the disk, &o you're just letting the computer know 
you want the program saved to disk. 

After you press J^IEHH ^^^ disk will start to turn and the conipjter 
will respond with; 



SAVING "PRCiGRflM NflME' 

OK 

REODV 



PRINT AND CALCULATIONS 



Now that you've gotten through a couple of the more dirdcult opera- 
lions you need in order to keep the prcgrams you like, lets start making 
some programs for you to save. 

Try typing the fflllflwlng exartly ns shown: 




If you ma<e a typing mistake, uic the Q^^Q key to erase the char- 
acter immediately to the left of the cursor. You can delete as many 
charocters as necessary. 

Let's see what went on in the example above. First, you instructed 
(commonded) the compute' to PRINT vi/hotever was inside the quots 
murks. By litting ^^^^Q you told the computer to do what you in- 
structed and COMMODORE 64 was printec on the screen. 

When VQU Jie the PRINT stotemeni in this form, whatever is enelnsed 

in quotes is printed exgctly as you typed It, 
If the campjter responded with: 

?SYNrA)( ERROR 

ask yourself if you made a mistake in typing, or forgot the quote marks. 
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The computer is precise and expects inslructions to be giver in a specific 
form, 

&ut don't get worried; just remember to enter things as we present 
them in the examples ond you'll get along great v/ith the Commo- 
dore 6-i. 

Renierriber, you ttiri'l Ihurl ihe corupuler ay typing o i llj urni llie besi 
way to learn BASIC is to tr/ different things and see what ^oppens. 

PRINT is one cf the most useful and powerful commands in the BASIC 
language. With it, you con disploy just about anything you wish, inc ud- 
Ing grapliics and results of computations. 

For example, try the following. Clear the screen by holding down the 
^^Q key and Birntill!3 key and type (be sure to use the 'V key for 
one, not a letter 'I'): 




What you've discovered is that the Commodore 64 is a colculotor in its 
basic form. The result of "24" was colcjiated and printed automatically. 
In fact, yoi,' con also perforn subtraction, multiplicotfon, division, ex- 
ponentiation, and advanced moth functions such as calculating sqi-qre 
roots, etc. And you're not limited to a single calculation on a line, but 
more on that later. 

Note that in the above form, PRINT behoved differently from the first 
example. In this case, ci value or result of a calculotion is printed, rather thon 
the exact message you entered because the quote marks v/ere omired. 

ADDITION 



The plus sign ( + ) signafs addition: we instructed the computer to print 
the result of 12 added to ]7. Other arithmetic operations take a similar 
form to addition. Remember to alwoys hit BflHIHW after typing PRINT 
and the calculation. 
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SUBTRACTION 

To subtract, use the conventional minus (-) sign. Type: 



PRINT 12-3 

3 



MULTIPLICMION 

If you wanted 10 multiply 12 Times '2, use ttie asterisk (') to represent 
mult! plication. Vou would type: 




DIVISION 

Divi^icri uses the iam'iWar"/". For example, to dtvide T44 by 12. type: 




24 



EXPONENTIATION 

In a like fashion, you can easiiy ■■aise o number to a power (this is the 
same as multiplying a number by itself a specified njmber of times}. 
The '*' {Up arrow) signifies exponentiatiori. 



PRINT 12 t 5 

£48832 



This Is rh« same as typing: 



F1?JNT 12 ♦ 12 * 12 * 12 * i; 
24aS32 



TIP: 



BASIC ho! a number af shcrtiriit wn/.-i iif finiig things. One stcli way is cbbrevfat- 
irg BAsIC commands (or keyjvordi). A ? con :5e US*H in F>lncs nf PRINT, fnr exam- 
ple. As WB go on you'll be presented with m<my commnnris; AnpF?ndix D shnwjs the 
abbrevi<ation& 'for oach ond whcil ^ill bA displayed on the screen v^hen /oij t^pe the 
abbreviated form. 



The last exomple brings up unylher inportcint point: many calcula- 
tions may be performed on the sanre line, and they can be of mixed 
types, 

You couid ccilculcit& this prohlem: 
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Up to this point vA^e've just U6ed smoll numbers and sirnple examples. 
Huweverj the Commodore 64 is capoble of more complex calculotions, 

Ybu could, for example, add a number of large figures together. Try 
this, but don't use any commas, or you'll get an error: 




Thai looks fine, but now try this: 



? 12123123.45 + 345.79 + 789S.6S: 
12131364.9 ^^ 



If vou too< the time to add this up by hand, you would get a different 
result. 

What's Qc'ing on here? Even though the computer has a lot of power, 
there's a limit to ttie numbers it can handle. The Commodore 64 can 
work with numbers containing 10 digits. However when a number is 
printed, only nine digits are displayed. 

So in our example, the result was "rounded" \<j Hi ir the proper 
range. The Cornmodore 64 rounds up when the next digit is Hve or more; 
it rounds down when the next digit is four or less. 

Numbers behA-een 0.01 find 999,999,999 are printed itiing standard 
notation. Numbers outside this rcinge ore printed using scientific nolti- 
lion. 

Scientific norcttion is just a process of expressing a very large or snail 
number as a power of 10. 

If you type: 



1.23E+17 
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Ihis is The same a: 1.23 * lOJl? and is used just to keep Things tidy. 
There is a limit to tne numbers the computer con handle, even in 
scientific notcition. These limits ore- 

Largest; ± 1.7014neGE I 36 

Smallest (different from lero): ± 2.93873588-39 

PRECEDENCE 

If you tried to perform some mi/ed talculuiiona different from the 
examples w= showed earlier, you might not have gotten the results Ihot 
you expected. The reason is that the computer performs calculations in a 
certain order. 

In thia calculation: 

20 + 8/2 
you can't toll whether th© ctnswer should be 24 or 14 un-11 you know \i 
which order to perform the calculations. If you add 20 to 8 divided by 2 
(or 4), then the result is 24. But, t you add 20 plus 8 and then divide by 
2 the answer is 14. Try the example and see whot result you get. 

The reason you got 24 Is because the Commodore 64 performs calcu- 
lations left to right according lo llie following; 

First: — minus sign indicating negative numbers 

Second; f exponentlatioij left to right 

Tlilrd: *f multiplication cind divisions, left to ight 

Fourth: -I- — addition and subtraction, lef^ to right 

foWovf along occording to the order of precedence, and you will see 
that in The above example the divisloi vi^as perforned first and then the 
addition to ge* c result of 24. 

Make up some problems of your own and see if you can follow along 
and predict ths results according to the rulas set dov/n above. 

There's alio an sosy wuy lo alter the precedence process by using 
parentheses to set off which operations you want performed first. 

For example, rf you wont to divide 35 by 5-plus-i you type; 



/ 5 1- 2 
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you will get 35 divided by 5 wi'^h 2 added tc the answer, which is not 
what you intendsd at all. To get whnt you reolly wantec), try this: 





my^i^^^ 



what happens nov/ is that the connputer evaluafes v/hat i^ contained 
in the parentheses first. If there are parentheses w/lthin parentheses, the 
innermost parentheses are evaluated frst. 

Where *here are a number oi parentheses on a line, sjch as: 



147 



the computer evaluates them left to right. Here 21 wojld be multiplied 
by 7 for the result of 147. 



COMBINING THINGS 



Even fhough we'/e spent a lot cf time in areas that might not seem 
v&ry Innportcnt, the cetails presented here will make more sense once 
yau start to program, and will prove invaluable. 

To give you an idea how things fit in place, consider the following: 
how could you combine the tv/o types of print stotements we've exom- 
ined so far to print something more meaningful on the screen? 

WA? know that by tfnclfiing somt^thing withi'i qugte tnark^ prints thol 

information on the screen exactly as it was entered, and by using math 
operators, cokulations can be performed. So why not combine the two 
types of PI?IMT statements like this: 



SEM CO.ON MEANS NO S:>ACE. 



"5*9 = " 
♦ 3 = 45 



! 5 * 9 



aa 



Even th&Lgh this might seem a bit reduncant. whot we've done is 
simply use both types of print slatements together. The first part arints 
"5 9 =" eAuc;tl^ as it wos lyped. Tht? seLurid purl does tiii? ugluul work 
and prints the result, w'th the sennlco'on separating the mes&age part ot 
ihe statenent from the a:;tual calculation. 

l^ou con 5epci''ate the parts of a mixed print ?tatement \A(ith punctua- 
tion for vorious formats. Try a comma In place of the semicolon and see 
what happens. 

For the CuriouSj the sen-icolon causes the next part of the stctement to 
be printed immediately after the previous part, without any spaces. The 
comma do«3 somethirg diffaren'. Ever though it is an acceptable 
separator, ii spoces things out more. If you type: 




the numbers will be printed across the Screen Qnd down on to the nsxt 
lino. 

The Commodore 64's display is organized into 4 areas of \0 coiumns 
each. The comma tabs each result into the next available area. Since 
we asked for mere information to be printed than would fit on one line, 
(we tried to frt frve 1 0-column area j on one line) tie last item was mov^ed 
dqwri Iq tiie nexf line. 

The basic difference between the comrrci and semicolon in farmatting 
PRINT statements can be used to our acvantage when creating more 
complex displays: it will albw us to cfeate some sophisticated results 
very eoaily. 



up to now we've performed some simple opercttions by enrering a 
single line of Instructicns into the Cfmpulsr. Once ^^3^| was de- 
pressed, the cperotfon that we specified waj performed immediotely. 
This is called the IMMEDIATE or CALCULATOR mode. 

But to accomplish anything significant, we must be able to have the 
computer operate with more than a single line stat^firienl, A number of 
statements conbined together is called o PROGRAM and ollcws you to 
use the full DOwer of the Commodore 64. 

To see how easy it is to write your first Commodore 6i program, try 
this: 

Cl*inr the screen by holding the ^^Q key, and then depres-sing the 

^^EJ3 key. 

Type NEW and press B|3UJ^. ;ihis just cleors out any numbers that 

might have been left in the computer from your experi meriting.) 

Nti\*/ type the follovi/ing exactly as shown (Remember to hit 

after each line) 




Now, type RUN and hit^^^^^l — wutch whqt happens. Your screen 
will come alive with COMMODORE 64. After you've finished watching 
the display, hit iaiJJB.t^<j jy to stop the program. 

A number of imporfcint concepts were introduced in this short pro- 
gram that are ihe basis for ull programming. 

Notice that here we preceded each statement with a number. This 
LINE nunber tells the compiter in what order to work i^/lth each state- 
ment. These nirnbers are also a reference point, in cose the program 
needs to get back to a particular line. Line numbers can be cny whole 
number (integer) value between 0-53,999. 

10 PRINT "COMMODORE 64" 

T^STArEMNI 
LPNF hlUMFLPB 
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criMMnnnRF 64 

iXiMMOnORE 64 

nriMt'ionoRE 64 

i::0!'irC(DORE 64 

nnMnoooRF 64 

rriMMODORE 64 
COMMODORE 64 
COt'^MODORE £.-1 
COMMOrrORE ^4 
COMMODORE €4 
i"'j~iMMi"irit"jOE: jt ^ ' 




1. i.fnj^iUL'UfKc: ti^ 
COMMODORE 64 
eRERK IN 10 
REFlDV 




■ 





It Is good p'ogramming proc-ice to number lines In increments of 
10 — in case ycu need to insert some staTenneits [titer on. 

Besides PRINT, our program also jsed another BASIC corrimard, 
GOTO. This instructs the computer ts go dir&etl/ to a Dorticulor line and 
perform it, then continue from that point, 

^ 13 PRINT "COMMODORE 64" 

- 20 GOTO 10 

In our exci'iiple, the prcgram prints the message in line TO, yotfS to 
the Text line (20), which instructs it tc go back to line ond print the 
mes&age over agoin. Then tne cycle repeats. Since we didn't give the 
computer a way out of this loop, the progrann w'll cycle endlessly, until 
we ph/siccilly stop it with the ^^^^^J key. 

Once you've stopped the program, type: LIST. Your progrann will be 
displayed. Intact, because it's still in the computer's mennorv. Notice, 
too, that the rompu-pr cnnvertpd ths ? into PRINT for ycu. The program 
can novv be changed, saved, or run cigoin. 

Another important difference between typing something in the im- 
mediate mode and writing a program is that once you execute and 
clear the screen of an itnnredicite statement, it'^ lost. Ho^wever, you ra\r\ 
always get a program back by juat t'^p ng LIST, 

By the way, when It conges to abbreviations dor'f forger that The 
computer may 'un out of space on a line if you use too many. 
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EDITING TIPS 

If you make a miEtake on a tine, yoj hove cr numboT of editng 
13 |j lions. 

1. You can retype a line anytime, and the computer %A/ilt automatically 
sjbstiruTe the new line for the old one. 

2. An unwanted line con be erased by simply typing the line number 
and KBITB^ . 

3. You can also cosily edit an existing line, using the cui'Sor keys ond 
editing keys. 

Suppose yoy made a hyping mistake in a line of the exomple. To 
correct it without retyping the entire line, try this: 

Type LIST, then using the QJ]Q| ond JlBHrWMi keys together move the 
cursor up until it is positioned on the line that needs to be charged. 

Now, use tho cursor-right key to move tlie cursor to the character you 
want to change, t/ping the change ove'' the old character. Now hit 
^^^^1 and the corrected line will replace the old one. 

If you need more spoce on the line, posltior the cursor where the 
space is reeded and hit ^^^] and ^^^^^J at the same tinne and a 
spot;e will oisen up. Now juit 'ype in tht: additional Informatluri and hit 
I^^QI . Likewise, you con delete unwanted characters by placing the 
cursor to the right of the unwanted choroctsr and hitting the ^^^^J 
key. 

To i/erif^ that changes wvere entered, type LIST again, and the cor- 
rected program will be displayed! And lines don't have to be entered in 
numerical order. The computer will automatically piece them ir the 
proper sequence. 

Try editng cur sanrple prog'am on page 33 by changing line 10 and 

adding a com-nci to the end of the line. Then KilN the program again. 



,ni a„,^,T -.,—-...., „r^„„^-, "~-DONT FORGET TO «CVE THE 

10 PRI NT "COMMODORE", 

■rOU RUM THE PRO&!iAIIA. 

VARIABLES 

Variables are some of the most used features of any programming 
language, because variobles can represent nnuch more informotion In 
the Computer. Understanding how ./ariables operate will make comput- 
ing easier a:id allow us to accomplish feats that -would not be possible 
otherwise. 



COrlMODORE 
COMMODORE 

COt-IMODORE 
COMHODORE 
COtlMODORE 
COMMODORE 
COI-fMODORE 
COMMODORE 

connoDORE 

COrtl'tODORE 

COCtllODORE 

COflMODORE 

COMHODORE 

BREFIK IN 10 

RERDV 



connoDORE 

COMMODORE 

cornnoDORE 

COriNOOnRE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
CDMMODCRE 
CntlMODGRE 
COMMODORE 
COMMODORE 
COMMODORE 



COMMUUtiRt 
COraiODORE 

copnooohE 

eOMMODORE 
COMMODORE 
COritlODORE 
COflMODCiRE 
COr-IMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 



UUMMUUOKE 
IXIPIMODORE 
LUnnODORE 

CUMMOLIOKE 

corinoDuRE 

COriMUUUKt 
COMMODORE 
COMMODORE 
COMMODORE 
COMMODORE 
COIIMOPORE 
COMModjORE 
COMMODORE 



Imagine a ronber of boxes within the computer that con each hold a 
number or a string of text characters. Each of these boxes is to be 
labeled with a name that we choose. That name is called o variable 
and represents the information in the respective box. 

For example, if we say= 

10 X% = 15 
20 X - 23.5 
30 X$ = "THE SUM OF X%+X - " 

The computer might represent the variables like this; 
X% 15 



Z3.5 



X$ THE SUM OF X%-X = 

A vo'toble name represents the box, or memory location, whero the 

current value of rhe variobig is stored. As you can see, we can assign 
either an integer number, floating point number, or a texl string to o 
va ricjble . 

The % symbol following o variable name indicates the variable will 
represent an integer number. The following are valid integer variable 
names: 
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A% 
X% 
Al% 
NM% 

The '$' following the variable name indicates the variable will repre- 
sent O text Strng. The following are examples of string varioblesi 
A$ 
X$ 
MIS 

Flualing point variables foliov./ tile same format, witt) the type indi- 
cator; 
AT 
X 
Y 
Ml 

In assigning a name to a variable tlene are a few things to keep in 
mind, hirst, a variable name can tiave one or two ciaracters. The first 
charocter mjst be an alphabetic character from A to Z; ttie second 
character can be rather nlphob^tic or numeric (n the range to 9). A 
third charocter can be included to indicate the tj'pe of \/ariable [integer 
or t&xt string), % or $. 

You can use vciriable names having more than two alphabetic 
characters, but only th» fint two are recognized by the c«rrputer. So 
PA and PARTNO are the same and v^/ould refer to the same varlaale 
box. 

The last rule for variable names is simple: -hey can't rontair any 
BASIC keywords (reserved words) such as GOTO, RUN, etc. Refer baci; 
to Appendix D for gi complete Mil of BASIC reserved words. 

To see hov/ variables can be pu* to v/ork, type in the complete pro- 
grom that we introduced earlier and RUN it. Remember ro hit | 
after eazh line in the progrom. 



10 KK = 15 

20 X = 23.5 

39 >i* = "THE SUN OF 

40 FRirtT "KK = "; x; 

50 PRINT -f^ 
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]f you die everything at shov/n, you shoufd get the -follov/ing resuff 
printtid on \\ifd scrt^en. 



i = 15 X = 23.5 . 

THE sun OF KK + X = 38.5 



We've put Together all the tricks learned so far to fcrmat xhs display 
as you see it and print the sum of the two variables. 

ii I nes 10 and 20 we assigned an integer volue to X% and assigned a 
floating point value to X. This puts the nurnber associated v/itii the vari- 
able in its box. In line 30, we assigned o text string to X$. Line 40 
combines the two types of PRINT statements to print a message and the 
actual valje of X% and X. Line 50 prints the text string assigned to X$ 
and the surr of X% and X. 

Note that ever though X is used as part of each variable narne, the 
identifiers % and $ make X%, X, and X$ unique, thus representing 
three distinct variables. 

But variable& are much nriDre powerful, (f you change their value, ths 
new value replaces the original value in the same box. Tliis ullows you 
to write a statement like: 

X = X + 1 

This v/ojid never be accepted in normal algebra, bui is one of the 
most used concepts in programming. It means: take the current value of 
X, add one to it and place the new surn into the box representing X. 



IF 



THEN 



Armed with the obility to easily update rhe value of variables, we can 
now try a program sjch as: 
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what we've done Is introduce Kvo new BASIC commands, and jnro- 
vided some control over our runaway little print progrom introduced at 
the Starr of ihis chaprer. 

IF . . . THEN adds some logic to ttie program. !t sa/s IF a condition 
holds true THEN do something. IF the condition no longer holds true, 
THEN do the next line in the program. 

A number ot conditions can be set up in using an IF . . . THEN slute- 
ment: 



SYMBOL 


MEAN/WG 


< 


Less Than 


> 


Greater Than 


= 


Equal To 


< > 


Nor Equal To 


> = 


Greater Than or Equal To 


< = 


Less Than or Equal Id 


The use of any one of these 


conditions is sirmple, yet sgrprijingly 


10 CT = 




-^ 20 ?"COMMODORE 64" 




30 CT = CT + 1 




-«- 40 IF CT < 5 THEN 20 




■ ' 




50 END 
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In the sample program, we've sef up a "loop" that has some con- 
stroints placed on it by saying: IF a voiue is less than some number 
THEN do something. 

Line 10 Seta CT (Count) equal to 0. Line 20 prints our message. Line 30 
odds one to the variable CT. This line counts how many times we do the 
loop. Each time ffie loop is executed, CT goes up b/ one. 

Line 40 ii« our control lins. If CT is less thcin 5, mefining v.(e've exe- 
cuted the Ic9p less than 5 tim^s, the program gc^^s bacl«: tc line 20 ^nd 

prints again. When CT becomes eqjol to 5 — indicating 5COAWiODORE 
64's were printed — the program goes to line 50, which signals to END 
the program. 

Try the program and see what we mean. By changing the CT limit in 
line 40 you can have any number of lines printed. 

IF . , . THEN has a multitude of other uses, which we'll see iri future 
exomples. 



FOR 



NEXT LOOPS 



There is a simpler, and preferred 'A/ay to accomplish v/hat vi/a did in 
the previous example by using a FOR . . . NEXT loop. Consider the 
following: 



10 FOR CT = 1 TO 

20 FRINT ••COMMODORE 6' 

30 NEXT CT ' 

RIJH 

COMMODORE St 

CGtlttODORE 64 

COMMODORE 64 

COMnODORE 54 

COMMODORE S4 



As you ccn see, the program has become much smeller and more 
direct. 

CT slurts ul 1 in linH 10. Then, line 20 does some printing. In Line 30 
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CT is increrrented by 1. The NEXT staTement in line 30 cutomaticolly 
sends the program back to line 10 where the FOR part of the FOR . . . 
NEXT statement Is located. This process vA/ill continue until CT reciches th = 
limit yog entened. 

The variable used in a FOR . . . NEXT loop can be incremented by 
snnaller amounts than 1, if needed. 

Try thi«; 



IS FOR m = 1 TO 10 STEP .5 
20 PRINT NB^ 
30 HEKl m 



RUN 




1 


1.5 


3 


3.5 


5 


5.5 






If you enter ar^d run this program, you'll see fhe nurnbers from 1 to 
10, by .5, printed across the display. 

All we're do'ng here is printing the values that NB assumes as it goes 
through the loop. 

You can even specify whether the variable is incrija&ificj or decreas- 
ing. Substitute the following tor line 10: 

10 FOR NB = 10 to 1 STEP -.5 

and v/alch tSie opposite occur, a* NB goes from iO tg 1 in descending 
ord&r. 
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INTRODUCTION 

The next 'ew chapters have been written ^or people who have be- 
come relatively fomiiinr with the BAS'C programming language and the 
concepts necessary to write rrore advanced programs. 

For those of you who are fust starring to learn how to progrgm, you 
may Fmd some of the infornr>ation a bit too technical to understand 
mmpletely. But take heort. , . because for these two fun chapters, 
SPRITE GRAPHICS and CREATING SOUND wave set up some simple 
exomples that are written for the new user. The e^^amples will give you 
a good idea of how to use the sophisticated sound and graphics 
capabilities available on your COMMODORE 64. 

If you decida thot you wont to learn more abaut Vi/riting program!; in 
BASIC, we've put ci bibliography (Appendix N) in the back of this man- 
ual. 

If you ore already familiar with BASIC programming, these chapters 
will help you get slorted with advonced BASIC programming techniqu- 
es. More (Jeluiled iniurmation can be found in the COMMODORE 64 
PROGRAMMiR'S REFERENCE MANUAL, available through your lo:al 
Commodore dealer. 
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SIMPLE ANIMATION 

Let's exercise some of tha Ccmnnodore 6A'9 graphic caoabiitie? by 
pyt"ing together wh<;3t v^e^ve 5^en so far^ together with ci f^w new c;5n- 
cepts. If you're cmbitiojs, type in the follov/ing program and see what 
hopperis. You will notice thcit within the prini statements we car also 
include cursor controls and icreen commends. Whan ycm spe something 
like {CRSR LEFT} in ci program lisUng, hold the ^^Q key and hit the 
CRSR LEFT/ RIGHT key. The screen will show tie grophic representation 
of a cursor left (two vertical reversed bars). In the same way, pressing 
-inri niBHTnro sho'ji/= ns fi rpvftrsed hfiart. 



NEW 




; INDICATES ^EW 

10 REM S0UNCINC5 BALL ^,..--^' ^ COMMAND 
20 PRINT "{CLR/HOrCl" 



25 FOR X = 1 TO 10 ; PRINT " {CRSR/OOWN} " s NEXT 

30 FOR BL = 1 TO 40 

40 PRINT"t^«-ECRSR LEFT]";:REM <• is a SHIFT-Q> 

50 FOR TM ^-St^TO 5 

60 NEXT TM -\ t THESE SPACES 



75 REM MOVE S^artT RIGHT TO LEFT (ARE INTENTIONAL 

80 FOR BL >^4B TO 1 STEP -1 

90 PRINT"? {CRSR LEFT) (CRSR LEFT}»tCRSR LEFT) 

100 FOR TM = 1 TO 5 

lie NEXT TM 

126 NEXT BL 

130 GOTO 20 
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TIP: 
































All words in 


thre 


text 


wil 


he 


comptfited 


nr 


one 


|[n@ 


. Hcwever, 


HS 


ona 


as 


you 


don't 


hit B!J!lill:IW 


yij^i 


64 


v>il( 


<;n.jri>mciticcjlly niove to 


the 


ne>^t 


ine even 


n tilt 


m 


dSt 


o-f o 


word. 

































The prograrr will display a bouncing ball nen/ing from left to right, 
and back again, across the screen. 

If we look at the progrcitn closely, (shown an pnge dA) ynii cart see 
how fiis feat was accomplished. 

Line 10 is a REMark that jjst tells what the progrom does; it has no 
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le f?Eri BOLTHCING BRLL 

-26 PfilHT "{CLR/HONE} " 

-25 FOR X = 1 TO 10 : PRINT " {CRSR/DOHH} " i NEXT 

30 FOR BL = I TO 46 

40 PRIWT" •fCRSR LEFT)"^-REM C* is a SHIFT-Q> 

-50 FOR TM = 1 TO 5 

■SB t-iEyj TM 

■70 NEXT BL 

75 REM MOVE SflLL RIGHT TO LFFT 

"80 FOR BL = 40 TO 1 STEP -1 

90 PRINT" ICRSR LEFT} {CRSR LEFT}«{CRSR LEFT] "; 

-100 FOR TM = 1 TO 5 

-110 HE:=<T TM 

•120 HEXT ei_ 

■ 1 30 GOTO 20 



effect on the program itself. Line 20 clears the screen of any informn- 
tioo. 

Line 25 PRINTs 10 cursor-down commonds. This just positions the ball 
in the middle o" the screen. H line 25 was eliminated the bcil would 
move OCrciSS the top line of tie screen. 

Line 30 sets up c loop for moving the ball the 40 columns irsm the left 
to right. 

Line 40 does a lot of work. It first prints a soace to erase the previous 
ball positions, then it prints the half, and finally it performs a cursor-left 
to get everything ready to erase tha current ball posfrion again. 

The loop ^et up In lines 50 ond 60 slows the ball down a bit by delay- 
ing The program. Without it, the bad would move too fast to see. 

Line 70 completes the loop that prints balls on the screen, set up in 
line 30. Eoch time the loop is executed, the ball movas another spacs to 
the right. As you notice from the illustration, we have set up a loop 
within a loop. 

This is perfectly occeptable. The only time /oj get in trouble is when 
the loops cross o*/er each other. It's helpful in writing programs to check 
yourialf os illustrated here to make sure the logic of o loop i* correct. 

To see whal wauld happen if you cross a loop, reverse the srotements 
in lines 60 and 70. You will get an error because the computer gets 

confused and connot figure out whcrt's going on. 

Lines 80 through 120 just reverse the step5 in the first part of the 
program, ond move the ball from right to left. Line 90 is slightly differ- 
ent from line 40 because the ball is moving in the opposilfe direction iwe 
have to erase the ball to the right and move to the left). 
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And when that's all done the program goes back to line 20 to stgrtthe 
whole process over again. Pretty neat! To stop the progronn hold 
down ^^^^3 ond hit ^^^^^^ 

For a vanalion on the program, edit line 40 to read: 



40 PRINT "•■'; *- 



TO MAKa ^He », MOID THE SHprr 

" KEY DOWN AND HIT THE linCS "Q," 



Run the prcgram and see what happens now. Because we left out the 
cursor control, each ball remains on the screen until erased by the ball 
mnving right to left in the second part of the program, 

INPUT 

Up to now, everything within a program has been set before it is rgn. 
Ortce the program was started, nothing could be changed. INPUT 
allov/s us to pass new information to a program as it is running and 
have that new informction acted upon. 

To get an idea of how INPUT works, type NEW ^^^^^cind enter this 
short program: 




What happens when you run this program is simple. A question mark 
will oppeor, indicating thot the computer is wating for you to type 
something. Enter ony character, or group of characters, from the 

keyboard and hit ^^^^9. The ccnn|Suter will then reEpond 'A'i+h "YOU 
TYf'ED ;" foliov^ed by the informafior you entered. 

This may seem very elementary, but imagine \A^hat you can have the 
computer do with any information you enter. 

You can INPUT either numeric or string varicitiles, and even hove the 
INPUT statement prompt the user with a message. The format of INPUT isr 

INPUT "PROMPT MESSAGE" ^VSiRI ABLE 



■ WOWPTMUST >E 3B CHAIACTERi at LiiS 
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Or, just: 

INPUT VARIABLE 

NOTE: To gel oot of this program hold down the ^^^^^ °"^ 
^^^^] keys, 

Tl^ie following program is not only useful, but demonstrates o lot of 
what has been preserrted so tar, including the new input stahement. 



HEN 



1 REM TEtlPERftTUF'E CDNVERSIOH PROGRAM 
5 PRINT "{CLR.-'HOMEJ " 

19 PRINT '■ CONVERT FROM FRHREHHEIT OR CELSIUS 
<F,^>"; INPUT fl* 

set IF R^ = "! (' THEM 29 

3Ei IF fid^ = "F" THEN 10Q 

4& IF R* O "C" THEN 18 

150 INPUT "ENTER CEGREES CELSIUS: " fC 

60 F = -ic^e^/s+ss 

70 PRINT Cf" DEC. CELSKJS = "j F.f" OEG, 

FAHRENHEIT" 
80 PRINT 
90 GOTO Ifii 

100 INPUT "ENTER DEGREES FRHREHHEITt " rF 
lie C - <F-32>*^<''9 

120 PRINT F.r" DEG. FRHREHHEIT = "jCt" OEG 
CELSIUS" 

rse PRINT 

140 C'OTQ 10 




If you enter and run this program, you'll see INPUT in action. 

Line 10 uses the input statement to not only gather information, but 
also print our prompt. Also notice that we can ask for either a number or 
string (by using o numeric or string variable). 

Lines 20, 30, and 40 do some checks on what is t/ped in. In line 20 if 
nothing s cnhcrcd (just ^^^^^| is hit), thon the progrom goes back to 
line 10 ond requests the input again. In line 30, if F is typed, /ou know 
the user vi/orts to convert a temperature in degrees Fahrenheit to Cel- 
.t;iiL<i, so the program branches to the part that does thai conversion. 

Line 40 doea one more check. V\rfe know there are only two valid 
choices the user can enter. To get to line 40, the user must have t/ped 
some character other than F. Mow, a check is rngde to see if that char- 
acter is □ C; if not, the program requests input again. 

This n-iay seem like a lot of detail, but it h good prograrrming prac- 
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tice. A jser nol ■familiar with the program can become ver^ frustrated if 
it does sometiiing strange because a mistake wcis mode entering infor- 
tnotion. 

Once we determine winat type of conversion to perform, tlie program 
does this calculation Cind prints out the temperature entered ord the 
converted temperature. 

The calculation is jyst s^ralgit math, using tlie estoblished formula for 
temperature conversion. After the calculafion is finished and answer 
printed, the p'ogram loops back and starts over. 

After running, the screen might look like this; 



CONVERT FROM FFlHREHHEIT OR CELSIUS -IF/'CJ : ?F 

EHTEfi: DEGREES FAHRENHEIT: 3~ 

32 DEG. FAHRENHEIT = DEQ. CELSIUS 

CONVERT FROri FFlHRENHEIT OR CELSIUS <F/C:j : 7 



After running the prngrnm, nrnke sore to save it on disk or tape. This 
program, as well as others presented *hroLghout the monuol, can form 
the base of your program library. 



GiT 



GET allows you to input one character ot a "ime from The keyboard 
without hittina B^BlSW . This really speeds entering data in nnany appli- 
cations. Whatever key is hit is ossigned to the var able you Specify with 
GET. 

The follov/irg routine illustrates how GET worics: 



NEW 

i PRINT ■■ {CLR/HOnE} " 

10 GET Rt: IF fi* = " t" THEN IS 

20 PRINT R*; 

36 GOTO 10 
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If you RUN the prograrr, the screen v/\\\ clecr and each time you hit o 
key, line 20 will print it on the disploy, and then GET another chorocter. 
It is important tc note thot the chcracter entered will not be displayed 
unless you specifically PRINT it to the screen, as v/c'vc done hore. 

The second statement on line 10 is also important. GET continuclly 
v/orks, even if no key is pressed (unlike INPUT that waits for a resoonse), 
so the second part of this line continually checks the keyboard jntil a key 
is hit. 

See whul hupaens if the second part of line 10 is eliminated. 

To stop this program you can hif tlie |ji|jQQ^j and [E^H3J keys. 

The first part of the temperature conversion program could easily be 
rewrittei to use GET. LOAD the temperature conversion program, and 
modify lines 10, 20 ond 40 as snown; 



10 PRINT "CONVERT FROM FAHRENHEIT OR CELSIUS 

2& OET Fl* : IF R* - 

40 IF fl* <:> "C" THEN 20 



This modification will tiake tiie program operate smoother, as nothing 
v/ill hapjoen unless the ujer Vpes in cne of the desirad respoTses to 
select the type of conversion. 

Once this change is made, make sure you save the new version of the 
program. 



RANDOM NUMBERS AND OTHER FUNCTIONS 

The Conniodore 64 contciriii o nuinber of functions thot ars used to 
perform special operations, f-unctions could be thought of os built-in 
programs included in BASIC. But rother than typing in a number of 
statements each time you need to perform a specialized cotculation, you 
ju3t type the command for the desired function cind ^he cornput^r dees 
tie rest. 

Many times when designing o game or educational program, you 
need to gsnerate a random number, to simulate the throw of dice, tor 
excniple. You tuuld certainly write a prcgran thcit would generate these 
numbers, but on eosier way to call upon the RoNDom number furctior. 

To see whot RND actually does, try this short program; 



4S 



MEM 

10 FOR X 

20 PRINT RND 

30 NEXT 



I TO 10/7F 

L 



YOU LEAi/E OUT THE COMMA YOUR L'ST] 
OF NUMBERS WtLL APPEAR 
AS 1 COLUMN 



After runriLng the pragram, you will see a display like this: 




Your numbers don't match? Well, If they did we w/ould all be In 
trouble, as they should be comaletely random! 

Try running the program a few mo'e times to verify that the results are 
aiways different, Even if the numbers don't follow/ any pattern, yoj 
shauld start to notice that some things remain the same every time the 
program is rtn. 

First, the results are always between and 1 , but never equal to or 
1 , This will certainly never do if we vjrtnf to simijinte the rondom toss of 
dice, since we're ooking for numoers between 1 and 6, 

The Other inportant feature to look for is that we are dealing with real 
numbers (with decimal places). This could also be a probleti since 
whote (integer) numbers are afien needed. 

There are a number of simple ways to p''oduce numbers f''om the 
RND furitlion in the range desired. 

Replace line 20 with the following and run the program again: 
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Tliut cured the problem of net having results larger than 1 , but we still 
have the decimal part of the result to deal witn. Now, another function 
can be called upon. 

The INTeger function converts 'eal numbers into integer valjes. 

Once mor*^ -epicce line 20 v/rth the following arid run t^ie prugrgjni to 
see ihe effect of The change: 



£9 PRINT 


1 NT <6*RHD (!>:)., 




RUH 






^+ 


3 1 e 




'fd 


4 5-5 
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That took care of a lot, getting us closer to our original goal of 
generating random numbers bct^veen 1 ond 6, if you examine closely 
what we gererared this last Time, you'll find that the results range from 
to 5, ony. 

As a last step, ode a one to the statenent: OS follows: 

20 PRINT INT{6*RND(1)] + 1, 

Now, we lave achieved the desired resu'ts. 

In general, you can place a number, variable, or any BASIC expres- 
sion \A.'ithin the porentheses of the iWT function. Depending on the range 
tleaired^ you jjst multiply the upper limit by the RND function. For 
example, to generote random numbe|'s betiween 1 and 25, yoi.i could 
type: 

20 PRINT INT(25*RND(1))+1 

The general formula for generating 3 set of randon numbers in a 
certain range ]5: 

NUMBER=INT(LOWER LIMIT t(UPPER-LOW£R+l)*RND(l)) 



GUESSING GAME 

Siiite v/e've yurie lo sums Imiglhs lu understond undorn numbers, 
why not put this infarmotion to use? the follov/ing game not only itlus- 
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trares a good use of random numbers, bui also iiTroduces some addi- 
fional progromming fheory. 

In running this program, a random number, NM, will be generated. 



NEW 

1 REM NUMBER GUESSING SAME ^ QUOTATION 

2 PRINT "tCLR/HOME}" 

5 INPUT "ENTER UPPER LIMIT FOR GUESS "-LI 
10 NM = INTCLI*RND<l>:J-t-l 
15 CH = 

20 PRIN-r "J-'VE GOT THE NUMBER." iPRIMT 
30 INPUT "WHRT-'S VOUR GUESS"; GU 
35 CN = CH + I 
40 IF GU > HN THEN PRINT "fW NUMBER IS 

LOWER": PRINT : GOTO 30 
50 IF GU < NM THEN PRINT "MV NUMBER IS 

HIGHER" : PRINI : GOTO 3© 
60 PRINT "CREHT! VOU GOT MV NUMBER" 
65 PRINT "IN ONLV "; CN ; "GUESSES. ": PR I NT 
70 PRINT "DO VOU WANT TO TRV ANOTHER <V/H)' 
80 GET HN*: IF flH*="" THEN 80 
90 IF HH* = "V" IHtN 2 
100 IF AN* <> "H" THEN 70 
110 END 



You can specify how large the number will be at tie sran of the pro- 
gram. Then, ifs up to you 1o guess what the number is. 
A sample run follows along with an explanation. 



I ENTER UPPER LIMIT FOR GUESS? 25 
'l-'VE GOT THE HUNBER. 

WHAT'S VOUR GUESS ? 15 
NV NUMBER I S H I GHER . 

NHFlT'S VOUR GUESS ? 20 
HV NUMBER IS LOHER, ' 

:WHfiT-'S VUJR GUESS ? 19 ' 
GREAT! VOU GOT MV NUMBER 
IN ONLV 3 GUESSES. 

iDO VOU i-m-iJ TO TRV RNOTHER ■CV/N; 
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IF/THEN statements compare your guess To the nwrnber generated. 
Depending on your guess, the program lelb you whether your guess was 
higher or lower than the random number generated. 

From the forTiula given for dstermiriirg raneom number range, see if 
yuu tun odd u few lines fo the prograrr that allov/ 'he user to also 
specify the lower range of numbers generated. 

Each -ime you make a guess, CN is incremented by I to keep track of 
the number of guesses, in usirg the program, see if you can use good 
reasoning to guess a number \n the least njmber of tries. 

When you get the right answer, the program prints out the "GRtAT! 
YOU GOT MY NUM,B£R" message, along with the nunnber of tries it took. 
You cnn then stcirt the process ovf?r agnin. Rpmembpr, the program 
generates a nev^ random number each time. 



PROGRAMMING TIPS: 



In lines 40 and 50, a ccslon h used lo sepyrtjle rnullijjts j^iutt^rni^rtl]^ on t^ sintjle line. 
This not orly saves Typfng, bu' in lofig programs will conserve memory ^poce. 

Also notice In the IF/THB^ sTaremerts on The same two lines^ we Instructed the 
computer to PRIMT something, rusher thuri irT^mediciJely branc^iing tc same o^her poin" 
Fr rh* prograin. 

The lost point illusTrgtes rhe reoson behind using Nre lumbers in iricremenTS of 10: 
After The- program was written^ we decidec tc add th-e count part. By just adding 
those new tines at the end o1 the pr&gromr numb&rec to foFI between the proper 
existing iines,, the progrcm wo5 eosily modified. 



YOUR ROLL 

The following program simufates the throw of two cice. You can enjoy 
it as it stands, or use it as part of a larger game, 



5 PRINT " C^r-s Xo try your luck? " 
10 PRINT "RED DICE = " :IHT<:6*RHDi: 1 j:> + 1 
26 PRINT "WHITE DICE = " ;INT<6*RNDa :5:i + l 
30 PRINT "HIT 3PHCE BAR hOR HNUTHtK ROLL" SPRINT 
40 GET fl*: IF R* = " " THEN 40 
50 IF R* = CHR*C32> THEN 10 

Care to try your luck? 

From what you've learned aboyt random numbers and BASIC, see if 
you con folloiA/ what is going on, 

$2 



RANDOM GRAPHICS 

As a final note on random numbers, and as an introduction to design- 
ing graphics, take a monrient to enter and run this neat liHle program: 



10 PRINT ■' ICLR/HOMC} " 

2tn PRINT nHRtt'205.5 + RNP';iSi; 






4e GOTr 


LI k'W 



As /O'j mcy hov« expected, lina 20 is the key here. Another function, 
CHR$ (Characier String), gives you a character, based on a standard 
c&de number trom to 255. Every character the Commodore 64 can 
print is encoded this way (see Appendix F). 

To quickly find out the code for einy character, just t/pe; 

PRINT ASCrX") 

where X is ttie character you're checking (this can be any printable 
character, including grrtphic.i) Th(^ rfesponse is the code for the char- 
acter you t^ped. As you probably figured out, "ASC" s onother function, 
which returns the standard ' ASCII" code for the character you typed. 
YoL car nov/ print that cha'octer by typing: 

PRINT CHR$(X) 

If you try typing: 

PRINT CHR$ (3fj); CHR$(a^6) 

you will see the two right side grnphic characters on the M and N keys. 
These are the two chafactefs that the program is using "or the maze. 

By using the formula 205.5 + RND(l) the computer will pick a random 
number between 205.5 and 206.5. There is a "ifty-fifty chance of the 
number being above or below 206. CHR$ Ignores any fractional values, 
50 half the time the character wfth code 205 is printed and the remain- 
ing rime code 206 Is displayed. 

If you'd like to experiment with this program, try changing 205.5 by 
adding or subtracting a couple tenths from it. This will give either char- 
acter a greoter chance of beiig selected. 



§3 



CHAPTER 



ADVANCED COLOR 

AND GRAPHIC 

COAAMANDS 

Color and Graphics 
PRINTing Colors 
- Color CHRS Codes 

• PEEKS and POKEs 

• Screen Graphics 

• More Bouncing Balls 



COLOR AND GRAPHICS 

up to now we've explored some af the sopKisticQied compjting 
capabilities of the Commodore 64. But one of its most fascinating feo- 
tures is an outstanding ability to produce color and graphics. 

You'vs seen a quick example of graphics In the "bouncing ball" and 
"maze" progran-s. But these only touched on the power /ou command. 
A number of new concepts will be introduced in this section to explain 

graphic ond color prcgrainmirg and show hov/ you can create your ov^n 
yurries urid advanced animation. 

Because we've concentrated on the conputing cOpobllitleS of the mo- 
chine, all the displays we've generated so far were a single color (light 
blu& -6x1 on CI darie blue baelcground, with a light blue border). 

In this chapter we'll see how lu odd color Jc proyrurns and cciitrol all 
those strange graphic symbols on the keyboard, 



PRINTING COLORS 

As you discovered if you tried the color alignment test in Chapter 1, 
y.:^u rrtn rhnnge teift colors by simply holding the ^^^H l^ey nnc one of 
the color keys. This works fine in the immediate mode, but \.vhat hap- 
pens if you wont to incorporate color chonges in your progroms? 

V/hen we showed the "bouncing ball" orogram, you sow how 
keyboard comnnands, like ctrsor movement, :ould be incorporated 
within PRINT statements. In □ like way, you can olso add text color 
changes to your programs. 

You have a full rarge of 16 text colors to work with. Using tfie^^Q 
key and a number key, the fcllowing colors ore available: 

12 3 4 5 6 7 8 

QIatk While Red Cytiri Purple Gieeii Blue Vellow 

If you hold down the Q key along with the appropriate number 
key these additional eight colors can be used; 



1 


2 


3 


4 


5 


6 


7 


B 


Orange 


Brown 


Lt. 

Red 


Gray 1 


Gray 2 


Lt. 
Grsen 


Lt. 
Blue 


Gray 3 



TYPE NEW, and experiment with the tcllow'ng. Hold down thel 
key aid at 'he sanne time hit theHkey. Next, hit theHkey without 
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^1olding down the ^^^ key. Noiv, while again depressing ths^^Hl^ey 
at the same Time hit The Q key. Release The^^^<,e/ gnd hittheQkey. 
AAove Through the numbers, alternating with the letters, ond type out The 
word RAINBOW as follows: 

10 PRINT-'^R^A^I^N^B^O^W" 



RUN 

RAINBOW 

JusT as cursor controls show as graphic cha-acTers within the quote 
marks of print statements, color controls are also represented as graphic 
characters. 

In the previous example, when you held down^^^ard typedQa 
"f was displayed. ^^flH displayed o "■*—". Each color control will 
display its unique graphic code when used in this way. The Table shows 
the graphic representations of f?cich printtii^le tolor contro . 
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KEYBOARD COLOR DISPLAY 

BLACK K 

WHITE M 

CYAN 

'URPLt 

GREEN 

BLUE 

YEILOW 

Even though The PRINT stntemert may look a bit strange on the 
screen, when you RUN the program, only the text will be displayed. Ard 
it will automotically change colors acco'ding to rhe color controls you 
placed in the print statement. 

Try a few examples of your own, mixing any rumber of colors within a 
single PRINT stotement. Re-nember, too, you can use tha second set of 
fe>t colors by using the Commodore key and I he number keys. 



KEYBOARD 


COLOR 


DISPLAY 


BO 


orj^ng: 




3Q 


B^OWN 


n 


SB 


LT. RED 


@ 




GRAY 1 


m 


S B 


GRAY 2 


" 


3B 


IT. tSREEN 


■1 


SB 


LT. ELUE 


□ 


mm 


GRAY i 


■■ 



TIP: 
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(rsvef 


e) changes 
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■'READY' 


prompt and 


any 


od 


citiondi 


tei<t you type 


is the 
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as the lost color 


or 


mode cfiorgs 
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Ifie 


normal dispioy. 
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COLOR CHR$ CODES 



Take ct brief look ot Appendix F, then fyrn back to fhis section. 
You may have noticed in looking over the list of CHR$ codes In 
Appendix F thot each color (oi well as most other keybcFord controls, 

such as cursor movemenfl has a unique code. These codes con be 
printed directly to obtain the same results as typing |9y| and the 
oppropriate ka/ within the PRIMT statement, 
for example, try this: 




The Text should now be green. In iiiuriy cuses, Lining the CHR$ func- 
tion will be much easier, especially if you want to experiment with 
chonging colors. The following progrorn is O different wav to get a rcin- 
baw of colors. Since there eire o rurnber of lines that aro similar (40- 
1 10) use the editing keys to save a lo1 of typing. See the notes after the 
listing tc refresh your memory on the editing procedures. 



NEW 



1 REI1 flUTOriflTI':: C-iJLOR BflR::. 






5 PRINT C:HR*>;147) : 


REM CHR*'; 


147 


>= CLR/H 


IS 


PF: i NT 


CMf.-4 < 18:?; 


1- '1 p . 


REM 


REVER^iE 


20 


CL = Ir^Tt;i5♦R^^D': 1 


:.'::■+ 1 






30 


DH CL 


ijOTO 40,50 


,.6i3,7e,S0> 


90., 


1 ee , I 1 


4e 


PRINT 


CHP:*>:;^.>! ; i 


liOTO le 






5e 


PRINT 


C--HF:*C2S>;; 


OOTO 10 






60 


PRINT 


CHRSrSdM : 


CPTO 10 






7e< 


PR I H7 


CHkS: -: 3 1 > ; : 


GOTO 10 






se 


PR I NT 


C:HR$ C 1 44 ; .! 


: OOTO 10 






yt< 


Ph: 1 1 J 7 


jjhh:? i. L Sf. ; .f 


! GOTO 10 






100 PRINT CHR*:C15£::j 


J : GOTO 10 






119 PRIHT CHR*:a53i. 


? : L-iOTO le 







BFlR 
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T/pe lines 5 through 40 normally. Your display should look like thij: 



5 PRINT CHRS'ri47 3 : REM CHR*(:i4?:> 

. ^ ,, j^ g .J , „ " ; . REM KE •■ 

22 CL = I NT i; S*RHD C I ;> J + 1 

3Q ON CL GOTO 4Q ,50 .60 .70 .80.90 , ItjO 

40 PRINT CHR*<.5.>:: GOTO 19 



EDITING NOTES 



lJs9 the CRSR-UP Itey to pos'rtion the cursor on line 40. Then type 5 
over the 4 of 40. Next, use the CR3R-RIGHT key to move over to the 5 in 
the CHR$ parentheses. Hit ^^Q Q^^3 ^° °P^^ ^P ^ sp<3ce and rype 
'28'. Now iust hit ^HIpW with the cursor anyv/here on the line. 

Th^^ display ^haulc novk/ look like this: 





HEW 

i r-p r" >,4 ^-|| 1 X fi M O T" r !"■ f ■" i"! 1 *"■<"■ ^-i i". r-i i". 






1 h!brl ULI 1 l.inH 1 i L '.-ULi 
5 PRINT t::HR*<147) : 

le PRINT CHP*--';i!3:J,r 
20 CL = 1HT03*:RND<1 
59 OH CL GOTO 48.,Se 
50 PRINT CHF*<;2ei? ! : 
■ 


-IK tih-IKi. 

REM CHR*(;i4?> = 
" ,r :REH RE 
>> + l 

GOTO id 


CLF 
;VEF 


?,-'HCiME 
10 



Don't worry, Line 40 is still there. LIST the prog rami and see. Using the 
same procedure, continue to modify the last line with a new line number 
nnrf CHR$ code until all the remaining lines have been entered. See, w.'e 
loid you the editing keys would come in handy. A* o final check, list the 
entire program to make sure all the lines were entered properly before 
you RUN it. 

Here i* a 5ho*t explanation of v^'hat's going on. 

YcPLi've probably figured out moat of the color bar program by now 
except for some strange new statement in lire 30. But let's quickly see 
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what the whole program actually does. Line 5 prints thti CHR$ code for 
CLR/HOME. 

Line 10 turns reverse type on and prints 5 spaces, v/hich turn out to be 
ct bar, since they're reversad. The first time through the prograrri the bar 
will be ligit blue, the nurrriul lest color. 

Line 20 uses our workhorse, the random function to select a ^andom 
color bet\A<een 1 and 8. 

Line 30 contains a variation of the IF . . . THFW s+otement which is 
called ON . . . GOTO. ON . . . GOTO allows the program to cIioosb 
from o list of line numbers to go to. If the variable (in this case CL) has a 
volue of I, the first lire number is the one chosen (here 40). If the value 
is 2, the second number in the list is used, etc. 

Lines 40 110 just convert our random key colors to the appiupriule 
CHR$ code for that color and return the program to line 10 to HtilN" a 
section of the bar in that color. Then the whole process starts over 
again. 

Sae if you can figure out how to produce 16 random nunnbers, ex- 
pand ON . . . GOTO to hondle them, and odd the remaining CHR$ 
codes to display the remaining 8 colors. 

PEEKS AND POKES 



No, wa're not talking about jobbing the computer, but we will be able 
to "look around" Inside the machine and "slick" things in there. 

Just as variables could be thought of as ci representation of "boxes" 
Vicithin the machine where you placed /our information, you can also 
think cA some specially defined "boxes" within the computer that repre- 
sent specific memory locations. 

The ConrmDdore 64 looks at these memory locations to see what the 
screen's background ond border color should be, what choracters are to 
be displayed on the screen — and where — ond a host of other tasks. 

By placing, "POKEing," a different value into the proper memory lo- 
ccitioii, we car change colors, define and move cbjscts, ond even 
create music. 

These memory locations could be represented like this! 



53280 
X 



53281 
Y 



53282 



532S3 



BQRDbR 
COLOR 



BACK(iROU[MD 
COLOR 
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On page 60 we showed just four locations, tv/o of v/hich control the 
screen and background colors. Try Typing This: 

POKE 532$1,7 BDH 

The background color of the screen w/ill change to yellow because we 
placed the value '7' — for yellow — in the locoTton That conirols the 
background color of the screen. 

Try POKEing different values Into the bockground color location, and 
see whot results you get. You con POKE any value bct^'een and 255, 
but only through 15 will work. 

The actual values to POKE for each color are: 






BLACK 


8 


ORANGE 


1 


WHITE 


9 


BROWN 


2 


RED 


10 


Light RED 


3 


CYAN 


11 


GRAY 1 


4 


PURPLE 


12 


GRAY 1 


5 


GREEN 


T3 


Light GREfN 


6 


BLUE 


14 


Light BLUE 


7 


YELLOW 


15 


GRAY 3 



Can you Think of a way to displciy the various background and border 
combinations? The following may be of some help: 




Two simple bops were set up tc POKE voriDus values to change the 
background and border colors. The DEU\Y Iood in line 50 jusT slews 
things dov/n a bit. 
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For the curious, try: 
? PEEK (53280) AND 15 

You should get a volje of 15, This is the last value BORDER was given 
and makes sense because both ths background and border colors are 
GRAY (value 15) after the program is run. 

By entering AND 15 you eliminate all other values except 1-15, be- 
couse of the way color codes are stored in the computer. Normally you 
would expect to find the same valup thnt wns Inst POKtd in the localion. 
In generol, PEEK lets us cxomine a apec'ffpc location and see what value 
is presenrly there. Can you think of a one line addition to the program 
that will display the value of BACK and BORDER as the program runs? 
How about this: 

25 PRINT CHR${147); "BORDER = ";PgEK (53280) AND 15, "BACK- 
GROUND = "; PEEK (532S1) AMD 15 



SCREEN GRAPHICS 

In all the printing of informotion thatyouVe done so far, the computer 
ncrmoHy handled inlormation in a sequential fashion: one character is 
printed after the next, starting from the current cursor positrun (except 
where yoj osked for a nev/ line, or used the ',' in PKINT formatting). 

To PRINT data in a particular spot you can star^ from a known place 
on the screen ond PRINT the proper number of cursor controlE to format 
the disploy. But this takes program steps and Is lime consuriing. 

Bur just as there are certain spots in the Commodore 64's memory to 
control color, there are also locations that you con use to directly control 
each location on the screen. 



SCREEN MEMORY MAP 

Since the computer's screen is copable of holding 1000 characters (40 
columns by 25 lines) there are lOCX) memory locations set oside to han- 
dle what is placed on the screen. The layout of the screen could be 
thought of a=. a grid, with each square representing o memory location. 

And since each location in merrnr/ con contain q number from to 
255, there are 256 possible values for each memory locatior. These 
values represent the different characters the Commodore 64 can display 
{see Appendix £), By POKEing trie value for a character in the apprc- 



priate screen memory location, that charocter will be displayed in the 
proper posiHon. 



COLUMN 

id 



30 



10S3 



1104 

114' 
116' 
122i 
126i 

mi 

134' 
138' 
Mi 
,W 
Adt 
:5« 

■Mi 

■.m 

■.7AA 

:m 
:m 
:8M 

■.3W 
:944 
Mt 



1 

~~Z'Z~ ZZ Z.—--—- — 

1 - ■ 



1023 



Streen memory in ttie Cornriiodore 64 normally begins ctt memory 
locaton 1024, and ends at location 2023. Location 1024 is the upper left 
corner of the screen. LocOtion 1025 S the position of the next character' 
to the right of that, and so on down the row. Location 1063 is the 
right-most position of the firsi row,-. The next location following the last 
character on a row is the first character ot the next row down. 

Now, let's say that you're controlling a ball bouncing on the screen. 
The belli is in ihe middle of th° screen, coltmn ?0, row 15 The formula 
for ccalculptior of th^ mennor^' location on th^ screen iS; 



POINT 



1024 



where X is the column and Y is the row. 

Therefore, the memory location of the ball is: 



1024 + 10 + 430 or 1524 



L 



COLUMN 
- ROW (40- 
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C'ear the screen with ^jjmj and yjjjjjjjjmj and type; 

POKE 1524,81 
POKE 55796,1 



1 



-COLC« 
- LOCATION 



COLOR MEMORY MAP 

A boll appears in the middle of the screen. You have placed a char- 
atler direuily inio streen rnernory williu'Jl usiny ihe PRINT stateTienl. 
The ball that appeared was white. However there Is a way to change 
the color of an obiect on the screen by altering another range of mem- 
ory. Type; 

POKE 55796,2^ 

The ball's color changes to red. For every spot on the Corrrnodore 64's 
scfeen there ore two memory locotions, one for the chcracter code, and 
the oth«r for *he color cods. The color memory map begins at loca-ion 
55296 (top lefl-hand corner), and continues on fcr 1000 Iccollons. The 



tOUIMN 
2] 



I 



55JK- 

iWi 

S5376 

55«B 
SS49« 

5K16 
5SG5« 

YMi 
557J6 
55n6 

5581 Fi 
S593€ 
56016 

ma 
am 
am 
am 
mis 
Sim 
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::=::::: :::±: ::::::x::: 

L, 



10 1 



20 



56295 
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same color codes, from 0-]5, that we used to chonqe bcrder and 

background colors con be used here to directly change character colors- 

The formulo we used for calculating screen memory Igpcations cgn be 

modified to give the locations to POKt color codes, fhe new formula is: 

COLOft PRINT -- 5529<1 - X + 4l3*Y 



MORE BOUNCING BALLS 

Here's a revised bouncing bail program tiiat priit; directly on the 
screen with POKEs, rgther than using cursor controls A-i'hin PRINT s+citc 
ments. As you wilf see after running the program, it Is much nrtore flexi- 
ble tnan the earlier prog-am, ond wfll lead up to programming much 
more sophisticated animation. 

NEI4 

le PRINT ■■{CLR.-'HOME}" 

ae POKE 53280,? : POKE 53281,13 

30 >i = 1 ! V = 1 

40 DX = 1 : DV = 1 

50 POKE 1024 + '?< + 40*V,S1 

Se FOR T = 1 TO 10 ! NEXT 

76 POKE 1024 + y. + 4a*V.32 

30 X = X + DX 

90 IF W < = OR X > = 39 THEN DX = -DX 

100 V = V + DV 

lie IF V < = OR V > = 24 THEN DV = -D't' 

120 GOTO 59 

Line JO clears the screen, and line 20 Sets the background to light 
green with a yellow border 

The X ond Y vo'lables in line 30 keep track of the current row ond 
column position of the ba I. The DX and DY variables in line 40 are the 
horizon'ol and vertical direction of the boll's novement. When o +1 is 
odded *o the X value the ball is movBd tn thp right; when —1 is oddf!cf, 
the boll moves to the left. A +1 added to Y moves the bolt dov/n a row; 

-1 cdded to Y nnoves the ball jp a row. 

Line 50 puts the bell on the screen at the current cursor position. Line 
60 is the familiar delay loop, leaving the ball on the sceen just long 
enough tc see it. 

Line 70 erases the ball by putting a space (code 32) v/here fhe ball 
was on the sceen. 
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Line 80 adds the direction foLlcr lo X. Line 90 tests to see if the ball 
has reached one of the side walls, reversing the direction if there's a 
bounce. Lines 100 and 110 do the same thing for the top and bottom 
walls. 

Line 120 sends the program botfc to displuy und mcves tha bell 
again. 

By changing the code (n line 50 from 81 to another character code, 
you can chongsth^ ball fo any other rharacier. If you chcirgs DX or DY 
to the ball will bounce straight instead of diagonally. 

We can also add a little more intelligence. So -or the only thing you 
checked for is the X ard Y vclues getting out o- bounds for the screen. 
Add the followirg lires to the prograrrt. 



21 FOR L ^ 1 TO 10 ^-/<^rRFFrj rriDF 

S5 POKE 1024 + INT;RHO<i>*1900>, iSt^"^ UUUC 

27 NEXT L 

S5 IF PEEKtie£4 + X + 40*V> - 16e THEt^ DK = -DX: 

GOTO 80 
105 IF PEEKt;iCi2:4 + X + 40*V.J = 16b THEN DV = -UV ! 
GOTO 13 e 

Lines 21 to 27 put 10 blocks on the screen in random positions. Lines 
85 and 105 check (PEEK) to see if the bail is about to bounce into a 
block, end changes the ball's direction if so. 
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INTRODUCTION TO SPRITES 

In previous chapters dealing v/ith graphics, wa sow that grophic 
symboU cauld bo used n PRINT slotements to creofe anima-ioT cind add 
chartlfke appeararces ro our displays. 

A way was also shewn to POKE character codes in specific screen 
memory locations. This would then ploce th? oppropriate character? di- 
rectly on rhe screen Ir the right spot. 

Creating animation In both these cases requires a lot of work because 
objects must be created from ejiisting graphic s/mbols. Moving the ob- 
ject requires a number of program statements to keep track of the ob- 
ject and mo/e it to a new spot. And, because of the limitation of using 
uruphic symbols, the shape and resolution of the object might not be as 
good as required. 

Using sor'ttes in anirrated sequences elimirates a lot af these prob- 
lems, A sprte is o high-resolutiorv programrnablo object that can be 
made into jusl obuul ony simpe — through BASIC comrriards. The ob|ecT 
car be easily moved abound the screei by simply telling the computer 
the position the sprite should be moved to. The computer takes care of 
thf? re-«it. 

And sprites nave much more power ihan just that. Their color can be 
changed; you can fell if one obiect collides with another; they can be 
made to go ir front and behind another; and they can be easily ex- 
panded in size, just for starters. 

The penalty for ctJI this ij minimal. However, using sorites requires 
knowing some more derails about how ihe Corimodo'e 64 operates and 
how numbers are handled witnin the computer. It's rot as difficult as it 
sounds, though. Just follow the examples and you'll be makiio your own 
sprites do amozing things In no time. 

SPRITE CREATION 

Sprites are controlled by a separate picture-maker in the Commodore 
6d This picture molcer hondles the video display. It does all the hard 
work of creating and' keeping track of chct'acters and graph cs, creating 
colors, and moving around. 

Tils display circuit has 46 different "ON/OFF" locations which act like 

intprnfll naemory location? Eoch of thete locciHons l^recilcs do'Ari into o 
series of 8 blocks, And each block can either be 'on" or "^ft". We'll get 
into rfiore detail about this later. By POKEing the appropriate decimal 
vqIls in the proper memory location you can control the formation and 

movement of your sprite crecttioriS, 



In addilion to accessing many of the picture making location? we will 
also be using some of the Commodore 64's mail memory to store infor- 
motion (data) tha* defines the sprites. Finally, f=?ight mprnory brntions 
directly after the screen memory will be used to -eli the computer exactly 
which memory area each sprite will get its data from. 

As we go through some exomples, the process will be very 
straightforward, and you'll get the hang o^ it. 

So let's get on with creating some sprite graphics. A sprite object is 24 

dots wide by 2i dots long. Up to eight sprites can be controlled ot a 
time. Sprites are displayec in a special independent 320 dot wide by 
200 dot high area. However, you can use your sprite v/ith any mode, 

high-resolution, Iow-re5olutior, text etc. 

Say you wont to create a balloon and have it flual around he sky. 
The balloon could be designed as in the 24 by 21 grid on page 70. 

The next jtep Is to convert the graphic design into data the computer 

CC*ri use. Get a piece of notebooic or graph poper and set up a scimple 
grid thot is 2] spaces down and 24 spaces across. Across the top write 
128,64,32,16,3,4,2,1, three times (as shoiA/n) for each of the 24 
squares. Number down the left side of the grid 1-21 for each row. Write 
the v,/ord DATA at the end of each row. Now fill in the gnd with any 
design or use the balloon that we have. It's easiest to outline the shape 
first and then go back and fill in the grid. 

Now if you *hink of all the squares you nlled in as 'on" then substitute 
a 1 for each filled square. For the one's that aren't fillec in, they're "off" 
so put a ze'o. 

Storting on 'he first row, you need to convert the dots irto three sepa- 
rate pieces of data the computer can read. Each set of & squares ts 
equal to one piece of data called a byte in our balloon. Working from 
the left, the first 8 squares are blank, or 0, so the value for that series of 
numbers is 0. 

The middle series looks like this lagoln a 1 indicates a dot, is a 
space): 



128 


64 32 16 


8 


4 2 


1 





1 1 1 


1 


1 1 


1 



+ 64+32 + 16+ 8f4+ 2+1= 127 

The third series on the first rov/ cilsa contains blanks, so it, too, eqLols 
iero. Tiius, Ihe data for the first line is; 

DATA 0, 127, 

m 



SERIES 
1 



SERIES 
2 



SERIES 

3 
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The series.that make up row two v^re calculated like this 
Series 1 

Seriej 2 
























1 




1 


1 


I 1 


1 


1 


1 1 1 


] 


1 



128+64+32 + 16+8 



r t 

2 + 1 



255 



ts 3i 



C 



t 1 

128 + 64 



= 192 



For row 2, the data would be; 

DATA 1,255,192 

In the soma woy, the three series tnot mcikc up each remaining row 
wuuld be converted into their decimal value. Take the time to dc the 
remoinder of the conversion in tl"i$ exarnple, 

Now that you have the data for your object, how can it be put to use? 
Type in the following program and sec what happeris. 
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I REM UP, UP,. FND fiWHV ! 
5 PRINT "{CLR/HOriE}" 

IG V= 53248 ! REM START OF DISPLflV CHIP 

II POKE V4-21,,4 I REM ENftBLE SPRITE 2 

12 POKE 2042 ..13 t REM SPRITE 2 DATA FROri 13TH BLK 
20 FOR H = TO 62i REHD Q b POKE 332+N,0! NEXT 

36 FOR X = B TO 209 ^^ — ■ gets rs imfo. fbou niii' 

4Q POKE V+4^Xi REM UPDRTE )< COORD I HATES 
50 POKE V+5,M: REM UPDATE V COORDIHflTES 
se MCXT M 
7Q GOTO 30,^iwo READiMFSOMQ- 

2ee CWTfl'iC 127, 0,1 ..255, 192, 3, 255, 224, 3, 23 1,224 

210 OflTfl 7,217,240,7,223,240,7,217,240,3,231^224 

220 DfiTfl 3,255,a24,3,255,224,2,25S,16e,l,127,e4 

230 DflTR 1,62,64,0, 15S, 128,0, ISe, 129, a, 73, a, e, 73,0 

240 DfiTR 0,62,0,0^62.0,0,62,0,0,28,0 

•Fnl WQfti DETAIL Ok READ & DATA StE CHAPTER 8. 

If you typed everything corrcctlyj your balloon U smoothly flying 
across rhe sky (page 72). 

In order "o urderstand what happened, first you need ta know what 
picture mcilting tarn-tioris rmtrol thp "unctions you need. These locations, 
called registers, could be illustrated in this manner: 

Regisferfs) Descriplion 

X coordinate of sprite 

1 Y coordinate of sprite 

2-15 Poired like nnd 1 for sprites 1-7 

16 Most Signfficant Bit — X Cocrdinate 

21 Sprite appear; I =appear 0=disappear 

29 Expand sprite in "X" Direction 

23 Expand .sprite In "Y" Direction 

39 - 46 Sprite 0-7 color 



In addition to this information you need to know from which 64 byte 
auction spri-es wifl get their cata (1 byte is not used). 

This data is handled by 3 loculiuiis direttly after screen menncry; 



20^0 , 41 



42 



43 I Ji I 45 " I 46 1 2047 "| 
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SPRITE 


1 


2 


3 


4 


5 


6 


7 



Now let's outline the exact procedure to get things mo/irg and firally 
write a proprom. 
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ACTUAL SCBEtN PHOTO 



There are only a few -Kings necessary to actually create and move an 
object. 

1. AAcike the proper 3prite(s] cppear or llie screen by POKEirrg into lo- 
cation 21 1 for the bit which turns on the sprite. 

2. Set sprite pointer (locations 2040-7} to where sprite dato should be 
read from. 

3. POKE cctual d(;ita into mennory, 

4. Through a loop, update X ond Y coordinates to move sprite around. 

5. YoJ can, optionally, exoand the object, change colors, or perform a 
variety of special f jnrtinns. Using locatlnn 79 In expnid your sprite in 
the ^'X^' direction and locotion 23 in the ''Y'^ direction. 

There are only a few items in tne program that might not be fomiiior 
frnm the disrussion sc far. 

In line 10; 

V=53243 
sets V to the starting memory location of tie video chip. In tils way v/e 
just increase V by the memory number to get the actuol memorY bcD- 
tion. The register numbers arei the ones giver on the sprite register mop. 
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In line 1 1 , 

POKE V+21,4 
makes sprite 2 appear by plocing a 4 in whaf is called fhe s.prite enable 
register (21) to turn on sprite 2. Think of it like this: 



JPRITES 



5[:rite number 




SprlT* Le^tl Nurtiber 



1 0,0 



= 4 



Put 3 1 Fof Th» SPRITE You Wont 

Each sprite level is represented in section 21 of the sprite memory and 
4 happens to be sprite level 2. If you were jsing level 3 you would pjt a 
1 in sprite 3 which has a value of 8, In fact if you used both sprites 2 
and 3 vol! would put a 1 in both 4 and 8. You would then add the 
numbers together just like you did with the DATA on your graph paper. 
So, turning on sprites 2 and 3 would be represented as V+21,12. 

Ir line 12; 

POKE 2042,13 
instructs the computer to get the data for sprite 2 (location 2042} from 
the I3tli area of memory. You know from makiny your sprite that it 
takes up 63 sections of memory. You may not ha^e realized it, but those 
numbers you put across the top of your grid equal what is known as 3 
bytes of the computer. In other word* each collection of the following 
numbers, 128,64,32,16,8,4,2,1 equals 1 byle of computer memory. 
Therefore with the 21 rows of your grid timss the 3 bytes of each row, 
each sprite fakes up 63 bytes of memoty, ____ , whole sp«ite 

20 FOR N = to 62; READ oTpoicE 832+N,Q! NEXT 

This line handles the actual sprite creation. The 63 bytes of dato that 
represent the sprite you erected are READ In through the loop and 
POKEd into the 13th block of memor/. This starts at locotion 832. 

30 fOR X = iSjrO 2d0 
40 POKE V + 4:X 
50 POKE V + 5.X 



SPRITE Is rcOORCiWATt^ 
5PRiTE7i Y CCORPiriA^ 
If you rememlie7from scnool the X coordinate represents an objects 
horizontal movement across the screen and The V coordtrare represents 
the sprite's vertical movement across the screen. Tlierefore as the values 
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of X change in line 30 from to 200 (one number at a time) the sprite 
moves across the screen. DOWN and TO THE RIGHT one space for each 
number. The numbers are READ by the computer fast enough to make 
the movemeit appear to he continiioiis, instead of 1 step at a time. If 
you need more details take □ look at the reglste' map in Appendix O. 

When yoj get into moving multiple objects, it would be innpossible for 
one nnennorY section to update the locotions of all eight objects, There- 
fore each sprite ha* its a\Mn set of 2 memory sections to nnake it move on 
the screen. 

Line 70 starts the cycle over agan, after one pass on the screen. The 
remainder o" the program fs the data for the balloon. Sure looks differ- 
ent on the screen, doesn'" it? 

Now, try adding the follo^A/ing line: 

25 POKE V-l-23,4 • POKE V+29,4. REM EXPAND 

and RUM the program again. The balloon has expanded to twice the 
original siiel What vwe did was simpla. By POKE ng 4 (ogain ts indicate 
sprite 2) into memcjry sections 23 one 29, sprite 2 was expanded in the 
X and Y directfon. 

It's important to note that the sprite will stort in the upper left-hand 
corner of the object. When exoanding an object in either direction, the 
starting point remains the same. 
For some added excitement, mcke the following changes: 

n POKE V4-21,12 

12 POKE 22(42,13 ; POKE 2043,13 

30 FOR X = 1 to I9S 

45 POKE V + 6,X 

55 POKE V+7,^9@-X 

A second sprite (number 3) has been turned on b/ POKEing 12 into the 
memory location tha* makes the sprite appear (V + 21). The 12 tum^ 
sprites 3 and 2 on {00001100 = 12). 

The added lines 45 and SS move sprite 3 around by POKEing values 
into sprite 3's X and Y coordinate locations (V + 6 and V+7). 

Want to fill the sky with even more action? Try making these addi- 
tions: 



[28 IS R[ALLY4.(5PfiITEZ) 
__ , (SfRITE 3) + 16 (SPnr 

11 POKE V+21, 28 

12 POKE 2042,13iPOKE 2043,13;POKE 2044,13 
25 POKE V+23,12 ; POKE V-f2P,12 

43 POKE V+8,X 
5B POKE V+9,l(30 



74 



zT+T) 

TE_4)_) 



In line 1 1 this Hme, onother sprhe (4} was nade to appear by POKE- 
ing 28 hro The appropriate "on" locarion of The sprite memory secTion. 
Now sprites 2-4 are on (0001 1100 = 28). 

Line 12 indicates thaT sprite 4 will get its data from the same 
memory area (13th 63 section area) as the other sprites by POKEing 
2044,13. 

In line 25, sprites 2 and 3 ore expanded by POKEing 12 (Sprites 2 
end 3 on) into the X and Y direction expanded memory locations (V+23 
ond V + 29). 

Line 43 moves sprite 3 olon9 the X ass. Line 53 positions sprite 3 
halfway dov/n the screen, cT location 100. Becouse This value does noT 
change, like it did before with X=0 to 200, sprite 3 just moves horizon- 
tally. 

ADDITIONAL NOTES ON SPRITES 

Now that you've experimented wirh spriTes, o few more words are in 
order. FirsT, you can change o sprite's color to any of the standard 16 
color codes (0-15) Thct were used to chancie character color. These can 
he found iri CHopt^r 5 or in opper^d.^ G. 

For example, to chortge sprite 1 to light green, type: POKE 
V+40,?J (be sure to set V = 5324S). 

You may have noticed in using the example sprite progratis that 
the object n&ver moved to the right-hand edge of the icreen. This was 
because the screen h 320 dots wide and The X diraction register can 
only hold a value Lp to 255. How Then can you get an object to move 
across tie entire screen? 

There is o location on the nemory map that has not been men- 
tioneo yet, Location 16 [of the map) controls something called the most 
signiflcanr bt (ArtSE) of the sprite'; X direc'ion location. In effect, this 
allows you tc move the sprite to o horizontal spot betVi^een 256 and 320. 

The MSB of X register works like this: after the sprite has been 
moved to X location 255, pbce a value into memory locotion 16 repre- 
senting the sprite you want to move. For e?fOmple, to get 2 to move to 
horizcntal locanons 256-320, POKE the value for sprite 2 which is (4) into 
memory location 16: 

POKE V+16,4. 

Now start from again in the usual X direction register for sprite 2 
(wtnich is in location 4 of the map). Since you are only moving another 64 
spoces, X Inrfitiort? would only 'onge between ard 63 tnis time, 
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This whole concept is besT illustrated with a version of the original 
sprite 1 program: 



le V= 1'3.2<-i&: POKE V+21 ^4 .- POKE 2042^13 

20 FOR N - TO 62 : READ Q : POKE SSZ-t-N^O : NEXT 

£5 POKE v+5, lee 

3e FOR K = e TO £55 

40 POKC V+4,^' 

50 NEXT 

ee POKE V+16.,4 

70 FOR N = Q TO 63 

30 POKE V+4, K 

90 HEXT 

lOO POKE V+lS.,0 

lie GOTO 30 



Line 60 sets the most significartt bi+ for sprite 2. Line 70 starts moving 
tne standard X direction location, moving sprite 2 the rest of the way 
across the screen. 

Line TOO is important because it ''turns off" the MSB so liial ttie 
sprite can start moving from the left edge of the screen again, 

To define nnultiple sprites, you may need additional blocks for the 
sprite data. Vou can use some of BASiC's RAM by moving BASIC Refore 
typing or loading your program type: 

POKE44,16;POKE16''256,0:NEW 

Now, you can usa blocks 32 throjgh 41 (locations 2043 throjgh 4095) to 
store sprite dalu. 

BINARY ARITHMETIC 

It is beyond the srnpe of this introductory manual to go into details of 
haw the computer liciridles riuriibers, 'irtfe will, however, pravide you with 
a good base tor understanding the process aid get you started on 
sopiiisticated animation. 

But, befor? you get too involved we have to define a few terms: 

BIT — This is the smallest amount of information n rompLtter can store. 
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Ttiirik yf u BIT lis a sv/itch that is either "on" or "off". When a BIT is 
"on" it has a value ot 1; when □ BIT is "ott" it has a value of 0. 

Afrer BIT, The next level is BYTE. 

BYTE — This is deRried cis a series of BITS. Since a BYTE is mode up of 
8 BITS, you can actually have a total of 256 ditterent combinations 
of BITS. In other words, you can have ail BITS "off" so your BYTE 

will Icok Ilka fhis: 



126 



64 



32 



I 



16 



I 



I 



1 



J 















and Its value will be 0. All BITS "on" h: 

12S 44 32 14 8 



I 



1 



1 



! 



1 



1 



which is 12a+64+32-M6+B+2+ 1=255. 
The next step up is called a REGISTER. 

REGISTER — -Defined as a block of BYTES strung together. But, in fhis 
case each REGISTER is really only 1 BYTE long. A series of REGIS- 
TERS makes up a REGISTER MAP. REGISTER MAPS are charts like 
the one you looked at to make your BA.LLOOM SH'i^lIb. fccch KfcGlS- 
TER controls a different function, like ttrning on the SP'^ITE Is really 
colled the FNABLF RFGISTFR. Winking the SPRITE longer is the EX- 
PAND X REGISTER, while making the SPRITE wtdor is the EXPAND Y 
REGISTER. Keep (n mtnd thoi a REGISTER Is a BYTE that performs a 
specific tosk. 

Now let's move on to the rest of BINARY ARITHAflETIC. 
BINARY TO DECIMAL CONVERSION 
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Using qsjmbinatiQMs of ull eiytrt bits, you can obtain any decimal value 
t''om to 255. Do you start to see v./hy when we POKEd character or 
colof vclues into nremor/ locotions the values had to be in the 0-255 
range? Each memory locotJon can hold a b/te of infornncition 

Any possible combination of eight O's and I's will convert to a 
unique decimol value between 0-255. If all places contain o 1 then the 
value of :he byte equals 255. All zeros equal a b/te value of zero; 
'0000001 I " equak 3, and so on. This uuill be the beisis for creating data 
that represents sprites and manipulating th^m. As just ore example, if 
this byre grouping represented port of a sprite (0 is a space, 1 is a 
colored area): 

2? 2^ 2* 2'^ 2^ 2^ 2"' ^ 



u 



iij: 



I 



I 



12S + 64 - 32 + 16 + at d + 2 + 1 + =255 

Then we s'vould POKE 255 nto the aparopriote memory Incction to 
represent that part of the ooject. 



TIP: 

To save you 'he trouble af :onverring binory numbers into decimal values — we'll 
need to do ttia' a lot — the fcilowing program will do the work for you. It's a gcod 
idee to enter and save the program for future use. 



5 REM BINRRV TO DECIMAL CONVERTER 
la INPUT "ENTER S-BIT BIHBRV NUMeER 



!R* 



12 IF LEN <ftiy 

GOTO IS 
15 TL = 
2S FOR 

30 TL = TL + 
40 NEXT K 
50 PRIMT Fl*: 
S0 GOTO 10 



<> S THEN PRINT "8 BITS PLEASE. . 

C = 
= 8 +.3 1 STEP -1 : C = c + 1 



BINRRV 



!TL: 



DECrriRL" 



This program takei your binar/ number^ which was entered as a string, ond looks 
et each ehoiocer of the string, from feftto right (the MID5 ti,nctiorK The variable C 
itidicot^s what etioracter to v/ork on as (he pfogran coes through the loop. 

The VAL functiott, in line 30, returns the ocual vclue oF the chorocte-. Since we 
ere dealing wi-h numeric charocters, the voLe is the some os the :h<irocter. ^or 
example, if the first zhora^ter of A$ is 1 then the volye would olso be 1. 

The -Inol por of lire 30 multiplies the volte of the current character by the proper 
power of 2. Since the first value is in the T7 ploce, in the example, TL woirld first 
equal I times 128 or 128. If the hit is then the value for that place would also be 
zero. 

This process is repeated for all eight characters as TL keeps 'rock of the running 
total decinol vaFue of the oiooiy number. 



I t 
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CHAPTER 



CREATING SOUND 



Using Sound if You're Not a Computer- 
Programmer 

Structure of o Sound Program 
Sempte Sound Program 
Making Music on Your Commodore 64 
Important Sound Settings 
Playing a Song on the Commodore 64 
Creating Sound Effects 
Sample Sound Effects to Try 



USING SOUND IF YOU'RE NOT A COMPUTER 
"PROGRAMMER" 

Most progrommers use computer sound for two purposes: making 
music and generating sound effects. Before getting into the "intricacies" 
□f pmgramming sound, let's tolce n quirk Ionic at ho\A/ n typirol sound 
program is structured . , , and give you a short sound program you can 
experiment with. 

STRUCTURE OF A SOUND PROGRAM 

To begirt with, there are five settings which yoj should know in order 
1o generate sound on your COMMODORE 64; VOLUME, ATTACK/ DE- 
CAY, SUSTAIN/RELEASE[ADSRK WAVEFORJM CONTItOL and HIGH 
FREQUENCY/LOW FREQUENCY. The first three settings are usually set 
ONCE ot the beginning of your program. The high and lov/ "frequency 
settings must be set for EACH NOTE you play. The waveforrr control 
starts nnd stnps pQch note. 



SAMPLE SOUND PROGRAM 

Before you start you have to choose o VOICE. There are 3 voices. 
Each voice requires different sound setting numbers for Waveform, etc. 
^ou car ploy 1, 2 or 3 voces together hut our snmpls uses only VOICE 



NUMBER 1. Type in this progrann I 
RETURN key after each line; 
First clear sound chip. 

1. Set VOLUME at highest setting. 

2. Set ATTACK/DECAY rotes to 
define how fast a note rises to and 
falls from its peak volume level (0 
to 255). 

3. Set SUSTAIN/RELEASE to define 
level to prclong note and rate to 
refecse it. 

4. Find the note/tone you wont to 
play in the TABLE OF MUSICAL 
NOTES in Appendix M ond enter 
the HIGH-FREQUENCY and LOW- 
FREQUENCY values for that note 
(each note requires 2 POKEs). 



ire by line 



be sure to hit the 



5 FORL=54272T054296: 
POKEL,0:NEXT 
le POKE54296J5 
2e POKE54277,190 



32 POKE 54278,248 



40 POKE54273,17:POKEM272,37 



«0 



5. Start WAVEFORM with one of 
4 standord settings (17, 33, 65 
or 129). 

6. Enter a time loop to set the 
DURATION ot the note to be 
played (c cuartsr note is approx. 
'250" but may vary since a ioncer 
program tan affetl ihe timing). 

7. Turn off note. 



50 POKE54276,17 



60 FORT -110232: NEXT 



70 POKE54276,16 



To hear the ncste you fust created, t>pe the word RUN and then hit the 
^^^^B ^^Y T" viftw thp progrctir type the word LIST and hit | 
To change it, retype the lines you -want to aller. 



MAKING MUSIC ON YOUR COAAMOOORE 64 



You con't have to be o musician to make music on your COAAAAODORE 
64] All ycu need to know are a few simple numbers which tell your 
computer hovj loud to set the vo ume, y/hich notes to p oy, ho'Ai long to 
play thein, etc. But first . . . hei'e's ci program whicii gives /ciu o qu ck 
demonstratton of the COMMODORE 64's incredible musie capabilities, 
using oily ONE of your computer's 3 separate voices. 

Type the word NEW and hit ^^^^^ to erase your previous pro- 
gram, then enter this pfogram, type the v/otd RUM aid ht the | 
key. 



S REM MUSICAL SCALE *- 



-Titli> n-F prA^tam. 



7 PORL=54272T054296;POKEL,ei;N£XT 

10 POKE 54296,15< 

20 POKE 54277,9 < 



30 POKE 54276,17* 

40 FORT=TTO3i30:NEXT^ 
50 READ A* 



'Sab valuma al highail leillng (1*). 

SuiJoir/Rc-lcass le/el ^each nst-e) 
■'Us-ler'mirt^i wa^Bfflrm |typ« at loundji 

~Durati«n (\\ow long) vscK notff plcryt. 

- Hr^di Rnl- nunl&*r In lln* 1 TCk l>ATA. 
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60 READ a*- 



70 tF& = -1THENEND ^ 



80 POKE 54273,A:POKE54272,B 



-R*9d4 4*cond ^v[nb«rir> line 110 DATA. 



ENDS »htn it READ> -1 In I 

'PO<<Es the firtl nufnbfrr tram DAT/, in IEn+ 1 T& fA" !?> 
<:•> HIGH neCUEUCV and tese.J luinbrr (C-dT) 
oi low FKEQUEMCV. Mint time piogram loops 
around it (tEAOS A as 19 on<l B ss £3, aid lo ati, 
and POKEithete ritmlnrjinti the HISHand LOV* 
PBEQIJfUCV loccitioni. Th» ni>mb*r 34^73-h4iCH 

FUeiajtmr far vqicei and i«7i=tow fut- 
QUENCr fir VOlCEl, 



85 POKE 5«76,17^ 



^ '^ Starl riiole. 

90 FORT = 1TO250,NEXT=POKE54376,16 l., t, pta, .t™n .«p r«. 
95 FORT = 1TO50: NEXT-* m. tor r.i,o«. 

100 GOTO20 < '■'"P' '"'='' '• ""*' CONTHOL and slO) n«« nsta. 

1 1 1 DATA 17, 37, 19, 63, 21 ,154,22,227 """"i "•** vaiuts fwr. nor* »!>iut ihon irApp*niiii 

120 DATA'25, 177,28,214,32,94,34, 175 " E«h poirot .um»r.repr«.nt.<ins n«t. for 

Miampio. 17 finH 37 rppmumt ^f" ^f 1^* ^th a<_ 

lowpj 1¥ ond M r*p-»i*nT "O" ond so on, 
9S^ DATA— 1,-1^- — ~ WK«ri ptetmn rtoch.i -I it turn M HIGW'LOW 

FR:QLEH£Y i^nln^i and EHDi <■$ Snstructvd in 
lini 70. 



To chcinge the sound to a "hcirpsichnrd," change Line S5 to read 
POKE54276,33 and Line 90 to read FORT= lTO2S0;NEXT;POKES4276,3! 

and RUN the program again. (To change the line, hit the j^^^^ key 
to stop the program, type the word LIST and hit^^^Jj, then retype 
the program line you want to change; the nev/ line will ootomatically 
replace ihe old one). Whar we did here is change the "waveform" from 
a "triongular' shaped sound wave "o a "sawtooth" vk'ove. Changing the 
WAVEFORM can drastically change the sound produced by the COM- 
MODORE 64 * . . but . * * waveform "s only one of 5*vercil settings you 
ccn change To moke different musical Tones and sound effects! You can 
abo change the ATTACK/DECAY rate of each note ... for example, to 
change from n "harpsichord" sound to a rrore "brmjo" sound try chang- 
ing lines 20 and 30 tc read; 



20 POKE54277,3 
30 POKE54278,0- 



SpfB. r/i »IH.*tiin fir han]* *I^Aeh 
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As ygu've jyst seen, you con make your COMMODORE 64 sound like 
different musical instruments. Let's take a closer look at how each sound 
setting works 

IMPORTANT SOUND SEHINGS 

1 V01UM£ — To turn on the volume and set it to the highest level, r^pe; 
POKE 54296,13. The volume setting ronges from to 15 butyou'll use 15 
most of the time. To turn "off" the volume, type: 

POKE 54296,0 

You only liave to set the volume ONCC ot the beginning of your pro- 
gram, since the same sefing activates aV three of the Commodore 64's 
VOICES. (CKanging the volume during a musicol note or sound effect 
can produce interesting results but is beyond the snopp of this introduc- 
tion,} 

2. ADSR and WAVEFORM CONTROL SETTING — You've already seen 
how changing the waveform can change the sound effect from 
"xylophone" to "harpsichord." Each VOICE has its &wn WAVEFORM 
CONTROL SETTING v^hich lets yoJ define four dHferent types of 
waveforms: Triangle, Sawioorh, Pulse (Square) and Noise. The CON- 
TROL also activates the COMMODORE 64's ADSR feature, but we'll 
come back to this in a moment, A somple waveform start setting looks 
like this: 

POKE 54276,17 
wEere the first number [54276) rep-esents the control setting for VOICE I 
and the second number (17) represents the start for a triangular 
waveform. The settings for each VOICE end WAVEFORM combination 
are shown in the table below. 



ADSR AND WAVEFORM CONTROl SETTINGS 





CONTtOt 
REQISTER 


TRIANGLE 


Not« Sloif/Stcp Numban. 
SAWTOOTH PULSE 


NOISE 


VOICi 1 


54276 


17/16 


33/32 


65/64 


129/126 


VOICE 2 


54283 


17/16 


33'32 


65/64 


129,' 128 


VOICE 3 


54290 


17/1 a 


33'32 


65/6i 


129,' 128 



Although tile control registers ore different for each voice the 
waveform settings are the same for each type of wavetorm. To see how 
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tliia works, look at Lines 85 ond 90 in me musical scale program. In this 
program, fmrnediatefy after setting the frequency in Line 80, we set the 
CONTROL SETTING for VOICE 1 in Line 85 by POKEfng 54276,17. This 
tLrrned on the COMTROL for VOICE 1 and set it to a TRIANGLE 
WAVEFORM (17). In Line 70 we POKE 54276,16, stopping the note. Ld- 
ter, we changed the waveform start setting from 17 to 33 to create a 
SAWTOOTH WAVEFORM ond this gave the scnie a "harpsichord" effect. 
See how the CONTROL SETTING and WAVEFORM interact? Selling the 
waveform is similar to setting the volume, except each vo\ce has its own 
setting ond instead ot POKEing volume levels we're defining waveforms. 
Next, v^'e'll look at another aspect of souncJ , . . the ADSR feature. 

3. ATTACK/DECAY SETTING— As we mentioned before, the ADSR 
CONTROL SETTING not only defines the v/aveform but It also activates 
the ADSR, or AnACK/DECAY/SUSTAIN/RElEASE feature of the COM- 
MODORE 64. Wfe'll begin by looking oi the ATTACK/DECAY setting. The 
following chart shows the various ATTACK and DECAY levels for each 
voice. If you're not fcmlliar with the concepts of sound attack and de- 
coy, you might think ot "attack" as the rats at which o note/sound arises 
to its MAXIMUM VOLUME. The DECAY is the rate at which the note/ 
sound foils from its highest volume love! back fo the SUSTAIN level. The 
follovving chart show/s the ATTACK/DECAf setting for each /oice, and the 
numbers for each attack and decoy setting. Note thot YOU AflUST 
COMBINE ATTACK AND DECAY SETTINGS BY ADDING THEM UP AND 
ENTERING THE TOTAL For example, you con set a HIGH ATTACK rate 
and a LOW DECAY rote by aoding the high attack number (64) to the 
low decay number (1), The total (65) will tell "he compLiter to set the high 
attack rate and low decay rate. You can also increase the ottock rates 
by adding them together (128 -I- 64 + 32 + 16 = AAAX. ATTACK RATE 
of 240). 

ATTACK/DECAT RATE SETTINGS 
ATTACIC' DECAY HIGH MEDIUM LOW LOWEST HIGH MED. LOW LOWIST 
SEniNG WTACK AnAOC ATIACK AITACK DECAY DECAY DECAY DECAY 



VOICE 1 


54277 


126 


64 


32 


16 


6 


4 


2 
2 


1 


VOICE 2 


54234 


12S 


i,4 


32 


\6 




4 
4 


VOICE 3 


54291 


i^e 


64 


32 


16 


1 


1 



If you set an attack rote with no decay, the d'ecoy is aLitomatically 
zero, and vice-versa. For example, If you POKE 54277,64 you set a 
medium attack rate with zero decay for VOICE 1, If you POKE 54277,66 
you set a nnedium attack rate and a low decay rate (because 66=644-2 
and sets BOTH settings). You can also add jp several attack values, or 
seyeral decay values. For es^annple, you can add a low attack (32) ond a 
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medium arrack (64) for a combined attQ::k rate of 96, then add a 
med'um decay of 4 and . . . presto . . . POKE 54277,100. 

Af this point, a sample pmgrnm will oefter fllustrata the effect. Type 
the word NEW, hit ^^^^^ and t/pe n this program ard RUN it; 

S FOR L=54272TO54296:POKEL,0:NEXT'« D^r,.™ rt„ „rt. =(«,.. 

10 PRINT"HIT ANY KEY' « Sc.n n.,.i<.3,. 

20 POK€.54296,^5< s.. ™i,me or higiwF i,^,i, 

30 POKE54277,64 «^— s.i AH«k'B.=<,y. 

40 POKEi4273,T7:POKE54272,37'*- poi, ..,,.>«. inr« voice i. 

60 GETKS:lfK$=""THEN60 -e— ch„k *,, i^yhoorf 

70 POKE54276, 17i FORT = TTO200: NEXT < s.,«»^^„m^ ,.,n.,^i.,. 

80 POKE54276, Hi;FORT = l TO50:N£XT < T„n ^ ..t-ino.. 

90 GOTO20 < Loo,, bock axd do it oaai.. 

Here, we're using VOICE 1 to create one note at a time . . . with o 
MEDIUM ATTACK RATE end ZERO DECAY. The key is Line 40. POKEing the 
ATTACK^DECAY setting with the nombKr 64 uttivutes u MEDIUM ottacit 
rate. The result sourds like someone bojncing a ball ir en oi' drum. 
Now for tiie fun part. Hit the ^^^^Q key to stop the program, then 
type the word LIST and hit ^^^^|. Now type this line and hit | 
{the now line 40 automatically replaces the old line 40): 

40 POKE 54277,193 



Type thtr wurd RUN ard hit ^^^^^^| tc set? how It sour'ids. What wt^'v^ 
done here is combine several attack and decay settings. Ihe settings 
are HIGH ATTACK (128) + LOW ATTACK<32) - LOWEST ATTACK {16) 
+ HIGH DECAY (8J + MEDIUM DECAY{il) + LOW DECAY(2] = 190. 

This effetl sounds like a suund an uboe or other "reedy" Inslrutnent 
might make. If ycu'd like to experirrent, try changing the waveform and 
Qttcck/decay numbers in the musical scale example to see how on 
"oboe" sounds. Thus . . . you ccn see that chonging the attack/decay 
rates can be used to create different types of sound effects. 

4. SUSTAIN/RELEASE SETTING — Like Attack/Decay, ths SUSTAIN/ 
RELEASE setting is activated by the ADSR/WAVEFORM Control. SUSTAIN/ 
RELEASE lets you "extend" (SUSTAIN) n portion nf a particular sound, like 
the "sustain pedcl" on o piano or organ whizh lets you arolong o note. 
Any note or sound can be sustained at cny one of 16 evels. The 
SUSTAIN/ RELEASE Setting may be used with a FOR . . . NEXT loop to 
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determine how long the note will be held at SUSTAIN volume before 
being rebased. TKe following ctiart shows the numbers you have to 
POKE to rench riifferert SUSTAIIvJ/RELEASE, rates. 



SUSTAIN/REIEASE RATE SEHINGS 

SUStolPi/ REIEASE mSH MEDIUM lOW lOWIST MIOM MfD, tOW lOWESr 

i:x>N»c>l SeTTINlj SUStAIN SUHAIN iUilAIN SUiMM KEIEASE HEUAiE REIEAJE JtElEME 



VOICE 1 


i^27S 


124 


6a 31 


i& 


6 


4 i 


1 


VOICE Z 


34235 


128 


(f4 3Z 


16 


a 


4 2 


] 


VOICE 3 


34292 


12S 


64 32 


16 


8 


4 2 


1 



As an exarrple, if youVe using VOlCEl, you can seta HIGH SUSTAIN 

LEVEL by typing: POKE 54279,129 or you could combiner HIGH SUSTAIN 
LEVEL witi a LOW RELEASE RATE by oddlng 128 + 2 and Iheri POKE 
54278,130. Here's the same sample program we used in the ATTACK/ 
DECAY section above , . . with a SUSTAIN/RELEASE feature added. 
Notice the diftererce in jounds. 



5 FORL=54272T054296:POKEL,O:NEXT ■ 

10 POKE54296,13 * 

20 POKE54277,64 * 



30 POKE54278,128< 

40 POKE54273,17:POKE5jt-272,37 ^ 
50 PRINT"HtT ANY KEY" ^ 



60 GETK$;IFK$=" "THEN60 "^ 

70 POKE54276,17;FORT=ITO200;NEXT ^ 
80 POKE54276,16=FORT=1TO50!NEXT< — 
90 GOTO60 "^ 



' Sat vQumt of higheil level. 

~ Sal Al1ack'D«cay. 

~ Sitl Suilaln/ftftiaaw 

"POKE fln» no** Into VOICE 1. 

~ Screen nietKig*. 

' Chick, ths keyboord. 

~ Sert Vfev«fcmi tanrtial (kiargb). 

"Tun &W 4«iti«^^4. 

' L»Cp back ami d^ [t gggfn. 



In Line 30, we tell the computer to SUSTAIN tfie note at a HIGH SUS- 
TAIN LEVEL (128 from chart above! . . . ofter which the tone is released 
in Line 30. You can v/ary the duration of a rote by changing the "count" 
in Line 70. To see the effect of using ihe release function try chonging 
Line 30 to POICE54278,B9 (SUSIAIN = 80, RELEASE - 9). 

5. CHOOSING VOICES AND SETTING HIGH/LOW FREQUENCY 

SOUND VQ^LUES — Each individual not© on ^h© Commodof© 64 raquires 
TWO SEPARATE POKE COMA^ANDS . . . one for HIGH FREQUENCY and 
one for LOW FREQUENCY. The MUSICAL NOTE VALUE table in Appendix 
M shows you the corresponding POKEs you need to pla/ any note in the 



CommocJoie 64's eiglit octave range. Tlie HIGH yrid LOW FREQUENCV 
POKE COMA'kANDS are ditterent tor each VOICE you use— ttiis allows 
you to program all 3 voi:es independently to create 3-yoice music or 
exotic sound effects. 

The HIGH and LOV/ FREQUENCY POKE COMAAANDS for eath voice 
are showr In rhe chart below, which also contains the NO IE VALUES for 
the middle (fifth) octave. 



VOICE NUMBiR POKI 






SAMPLE MUSICAL NOTIS- 


-HFTh OdAVi 






& FREQUENCY NUMBER 


C 


C# 


D 


D* 


E 


F 


f# 


G 


S# 


A 


A# 


B 


c 


C# 


VOICEl/HGH 
V0ICE1/L0W 


54273 
54272 


34 
7i 


36 
85 


38 
126 


40 
2O0 


43 

52 


45 
193 


48 

127 


51 
97 


54 

111 


57 
172 


6T 
126 


64 

188 


43 

149 


72 
169 


V0ICE2/HIGH 
V0ICE2/'L0W 


54260 
54279 


34 
75 


36 
85 


3a 

126 


40 
200 


43 
52 


45 
198 


48 
127 


51 
97 


54 
111 


57 
172 


61 
126 


64 

188 


48 72 
149 169 


V0ICE3/H GH 
VOICEr,/IOW 


54287 
549RA 


34 
7E 


36 
8.^ 


33 
126 


40 
2O0 


43 
5.2 


45 
198 


48 
127 


51 
97 


54 
111 


57 
172 


61 
126 


64 

ise 


48 72 

149 169 



As you con see, there are 2 settings for eucli voice, a HIGH FRE- 
QUENCY setting and a LOW FREQUENCY setting. To play o musical note, 
you must POKE a value into the HIGH FREQUENCY location and POKE 
onother value Into the LOW FREQUENCY locotion, Using the settings in 
our VOICE/FREQUENCY/NQTE VALUE table, here's the setting that plays 
a C note from the 5th oc"ave (VOICE 1]; 

POKE 54273,34:POKE 54272,75. 
The same note on VOICE2 would be; 

POKE 54280,34iPOKE 54279.75. 
Used in a program, it looks like tKiS; 



5 FORL=54272TO54296:POKEL,0;NEXT 

10 V = 54296'V/=54276=A=54277!* 

S = 5427S;H=54273iL = 54272 

20 POKEV,15:POKEA,190:POKES,6? * 

30 POKEH,34:POKEL,7i < 

40 POKEV/,33:FORT = lTO2e0:NEXT.« 

50POKEV/,32 ^ 



~ ^t numbers «qua[ hn letter}. 

POKE volume, vtavtioinir Oltoch/decoy. 

- FOkE hi/lo -f-B^, il*'** 

— van noie, l;t it ploy 

itop no-p 
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PLAYING A SONG ON THE COMMODORE 64 

The following program can be used fo compose or play a song [using 
VOICEl). There are "wo important lessons in this program; First, note 
how we abbreviate all the long control numbers in tha first line of the 
program , . . after that, we can use the letter W for ''Waveform" instead 
of the number 54276. 

The SBtond lesson toncerns the way we use the DATA. This program 
h set up to let you enter 3 numbers for each note: the HIGH FREQUENCY 
NOTE Vfl.LUE, the LOW FREQUENCY NOTE VALUE, and the DURATION 
THE NOTE WILL BE PLAYED. 

For thfs song, we used a duration "count" of 1 £5 for an eighth note, 
250 for a quarter note, 375 ior a dotted quarter note, 500 for a half 
not& and 1000 for a whole note. These number values can be increased 
or decreased to match a particular rempo, or your own musirol tnste. 

To see how a song gets entered, look at Line TOO, We entered 34 
and 75 as our HIGH ancJ LOW FREQUENCY senings to play o "C" note 
(from the sample scale shown previously) and then the number 250 for a 
quarter note. So the first note in our song is a quarter note C. The 
second riote is also a quarter note, this time the note is "E" . . . and so 
on to the end of our tune. You con enter almost any song this v^^ay, 
adding as many DATA statement lines as you need. You can continue the 
note and du'otton numbers from one line to the next but each liie must 
begin with tfie word DATA, DATA-1,-1,-1 should be the last line in your 
program. This line "ends" the song. 

Type the word NEW to erose your previous program and type in the 
following program, then t/pe RUN to hear the song. 

MICHAEL ROW THE BOAT ASHORE-1 MEASURi 

2 FORL=54272T0542S>6:POKEL,3:NEXT 

5 V=54296;W=54276:A=54277:HF=54273:LF=54272:S=5427a: 
PH=54275:PL=S4274 
10 F>OKEV,15:POKEA,Be:POKEPH,35:POKEPL,]5;POKES,e9 
20 READH:IFM = -lTMtNEND 
30 READL 
40 READD 

69 POKEHF,F:FOKELF,L:POK£W,65 
8J0 FORT=1TOD!NEXT!POKEW,64 
85 FORT=1TO50:NEXT 
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93 OOTO10 
190 DAIA34/75, 250, 43, 52,250,51, 97,375,43, 52,1 25,51,97 
105 DATA253,57, 172,250 

1 1 DATA5 1 ,97,500,0,0r T 25,43,52,250,51 ,97,253,57, 1 72 
115 PATAl 000,51,97,500 
120 DATA-1,-),-1 

CREATING SOUND EFFECTS 

Unlike music, sound effects ore more often tied to c specific pro- 
gramming "action" such as the explosion made by an astro-fighter as it 
crashes through a harne-r in a spoce gnrne . . or the warning bj77!&r in 
a business program that tells the user he's about to erase his disk by 
mistake. 

Vou hove a wide range of options avoilable if you want to create 
different sound effects. Here ate. 10 prrtgramming idfraa which might 
help you get started experimenting with sound effects; 

1. Change the i/olume while a note is playing, for ejiample to create 
an "echo" effect. 

2. Vary between two notes, rapidly to create a sound "tremor." 

3. Waveform . . . try different settings for tjutli vuiue. 

4. Attack/Decay ... to alter the rate a sound rises toward its "peak" 
volume and rate it diminishes from ihai peak, 

5. Sustain/Releose ... to change sustain to volume of a sound effect, 
and rate ir diminishes from that volume. 

6. Multivoice effects . . . playing more thai one voice at the same 
time, each voice independently controlled, or one voice playing 
longer or shorter than another, or serving as an "echo" or response 
lu o Prsl note, 

7. Changing notes on the scale, or changirvg octaves, using the values 
in the MUSICAL NOTE \ftLUE toble, 

3. Use the Square Waveform and different Pulse Settings to create 

different effects. 
9. Use the Noise Waveform to generate "w/hite noise" for accenting 

fonai sound effects or creating explosions, gunshots cr footsteps. 

The sorrie musical notes that create music cfin «lso he uspd with 'he 
Noise Waveform to creote differen- ^^pes of vi^hite noise. 

10. Combine several HIGH/LOW frequencies in rapid succession across 
different octaves. 

H. Filter ... try the extra POKE setting in Appendix M. 
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SAMPLE SOUND EFFECTS TO TRY 

The fallowing programs may be added to almost any BASIC program. 
They are included to give yoj some programming ideas and demion- 
strqte the Comnnodore 64's sound effect ronqe. 

Notice the programming shortcut we're using in Line 10. We con 
abbreviate those long cuTibersome sound selling numbers by defining 
them as easy-to-use letters (nunneric variables). Line 10 simply means 
that these easy to remember LETTERS can be used instead of those long 
numbers. Here, V = Volume, W=Waveform, A= Attack/Decay, H = Htgh 
Frequency (VOICE!), and L=Lc>w Frequency (VOICE!). \W(i then use these 
letters Insteod of numbers in our program . . . making our program 
shorter, typing fas-er, and the sound settings easier to remember and 
spct. 

DOLL CRYING 

!0 V = 54296:W = S4276:A = S4277: H = 54273:l = 54272 
20 POKEV,!5;POKEW,65:POKEA,.15 
30 FORX-200TO5STEP-2:I*OKEH,40:POKEL,X:NE)CT 
40 FORX = T5I3TO5STEP-2:POKEH,40;PO<EL,X:NEXT 
50 P0KEW,I3 



SHOOTING SOUND . . . USING VOICE 1, NOISE WAVEFORM, FADING 
VOLUME 

10 V=5429<i:W=54276:A=54277:H =54273:L=54272 
20 FORX=!5TO0STEP-l:POKEV,XrPOKEW,129;POKEA, 

!5:POICEH,4O:POKEL,20£!:IMEXT 
30 POKEW,0:POKEA,0 
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CHAPTER 



ADVANCED DATA 
HANDLING 

READ and DATA 
Averages 
Subscripted Variables 

One-Dimeitsional Arrays 

Averages Revisited 
DIMENSION 

Simulated Dice Roll V/ilh Arrays 
Two- Dimensional Arrays 



READ AND DATA 

You've E=en how to assign values to variables di'ectly within ttie pro- 
gram (A = 2), and llow to ossign different values while tKe progrgm is 

running — through the INPUT statement. 

There are many times, though, when neither one of these ways v/ill 
quite fit the job you're tr/irig to do, sspecially if it involves a lot of 
information. 

Try this short progrom: 



10 RE«D a 














20 PRINT ' 


■'h' IS HOW 


* 




H 






36 GOTO IQ 














4& DflTfl 1. 


34. 10,5 


r 


16. 


234 


'^^ M 


M^Mt^ 


RUN 










'-'fll 


HhHk 


H IS NOW : 


1 








fl 


H^Hk 


X IS HOW ! 


34 






■ 


JH 


[^^^^^^H' 


X IS NOW 1 


IQ.5 








'"1^1 


^^^^^^K^,: 


X IS HOW ! 


le 








''1^1 


^^^^^^^H^ 


X IS HOW ! 


234.56 








'1 


^^^^B 


?OiJT OF DRTR ERROR : 


LN 


10 




•fl 


^^^^B' 


RERDV 

■ 










■ 


^" 



In line TO, the computer READs one value from the DATA statement 
and assigns fiat value to X. Each tfme through -he loop the next value in 
the DATA sratetnent is read and that value assigned to X, and PRINTed. 
A pointer in t"ie computer itself keeps track of which value is to be used 
next: 



i 



40 DATA 1, 34, 10.5, 16, 234.56 



When all the values have been used, and the computer executed the 
loop again, looking for onother value, the OUT OF DATA error wds dis- 
played because there were no more values to READ. 
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It is important to follow the format of the DATA statement precisely: 
-d0 DATA 1, 3i(, 10.5, T6, 23J-56 
t t 

Dcittj sitilfcsrnents icin contain integer numbers, real numbers (234.65), 
or numbers expressed n scientific notation. But you can't READ other 
variables, or hove arithmetic operations in DATA lines. This would be 

incorrect: 

40 DATA A, 23/56, 2*5 

You can, however, use a string variable in a READ statement and then 
place string information in tfie DATA line. Tne follovi/ing is acceptabte: 



HI 


EM 






11 
1! 

£■1 
31 
41 


3 FQ 
5 RE 
3 PR 
HE 

a DF 


R X - 1 -to 3 

I NT "ft* IS HOW J "; 
XT 

TFI THIS, IS, rUH 


R* 


RUM 






fl* IS NOW : THIS 
Pif IS NOW t is' 
ft* IS NOW ! FUM 
REHDV 







Notice that this lime, tiie READ itcitement wos placed Inside a POR 
. . . NEXT loop. This loop was "hen executed to match the number of 
values in the da'o statement. 

Iri man/ cases you will change the number of values in the DATA 
statement eacl^i 'ime the program is run. A wa/ to avoid cojnting the 
number o' values and still avoid an OUT OF DATA ERROR is to place a 
"FLAG" as the last value in the D.ATA line. This would be a value that 
your data would never equal, sued as a negative numbor or o very 
large cr small number. When that valje is READ tine program will 
bronch to the next part. 

There is o v/ay to reuse the same DATA later in the program by RE- 
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STOREing the doto pointer to the beginning of ihe dcata list. Add line 50 
to The previous pragram: 

50 GOTO 10 

You will EtiK get the OUT OF DATA error becousc os the program 
brunclie:] back to line 10 to reread the data, the data pointer indicates 
all the data has been used. Now, add: 

45 RE5TORE 

and RUN the program again. The dato pointer has been RESTOREd and 
the dafQ can be READ continuously. 



AVERAGES 

The following program illustrates a practical use of READ and DATA, 

by re^oding in a set of numbers and calculating iheir civeroge. 



T - : CT = ! 

10 re: no K 

20 IF X - -1 THEN SB: REM CHECK FCiR FLFtG 

-- T - CT + 1 I 

yy 1=7 + ;^: pEM UPDATE! TOTAL 

40 GOTO lO 

5© PRINT "THERE HE:RE "; CT;"VrtLUES RERD" 

6& PRINT " TOTAL = ".-T j 

?e PRINT ■'liVERRi3E ="; T/'CT 

8e DflTR T-S, S«^ 6£. 91.. 67, 33,, 78, -I 



RUN 

THERE WERE 7 VftLLES REfiD 



= 86.85? 1429 



Line 5 sets CT, the CounTer, and T, Total, equal to zero. Line 10 READs 
a value and ossigna the value to X. Line 20 cliecks to see if tfie value is 
our flag (here a -I). If the value READ Is part of the valid DATA, CT is 
incremented by 1 and X is addeo to the totol. 

When the flag is READ, the program brarches to line 50 which PRINTs 
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ihe number of values read. Line 60 PRIMTs the totcl, ard line 70 divides 
the total by the riLmber of values tn get the nverrige. 

By using o f\og at the end of -the DATA, you can ploce any number of 
values in DATA statements — which may stretch over several lines — 
without worrying about counting the njmber of values entered, 

Anothe' voriation of the READ statement involves assigning irfcrma- 
tion from the same DATA line to different variables. This irformation can 
even be a mixture of string data and numeric values. You con do all this 
in the tollowing program that will READ o name, some scores — say 
bowing — and print the name, scores, and the average score: 



le READ H*,n..Ei.,C 

20 rRIHT H*;"-S SCORES HERE: 

3S PRINT "ntCi TIC riVERnOC IS 

40 PRIt>IT: GOTC 03 

50 PRTR MIKE., 190, 1S5, 1^5.. 



r'JfltDtC: 



■li^m 



6& DRTH JOHN^ 155, 



205 _, PRUL 



£25, 245, 190 



I'S SCORES WERE: 19© 

fFHD THE HVERRGE IS : 1S9 



1:35! ie;5 



DICK'S SCORES WERE: 225 245 19& 
FIND THE FiVERFlGE IS : £28 



In running the program, the DATA statements v/ere set up in the some 
order that the READ statement expected the irformation: a narre (a 
string), then three values. In cither words N$ tue first time through gets 
the DATA "MIKE", A in fliK READ corresponds to 1 ?0 in the data state- 
ment, "B" to 185 and "C" ta 165. The process is then repeated in that 
order for the remainder of the information. (Dick and his scores, John 
and his scores, and Paul and his scores.) 

SUBSCRIPTED VARIABLES 

In the poit we've jsed only simple BASIC variables, sjch os A, A$, 
and NIL tci represent vakes. These vi/ere a siigle letter "ollowed by q 
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letter or single digit. In ony ot the programs that you i/vould write, it is 
doubtful that we would have a need for rrore variable nomes tKati 
possible uvith all the combinations of letters or numbers available, Bui 
you ar& limited in th^ way variables gre vsed with pr':;grams, 

Novu let's intrsduce the concept of subscripted variobles. 

A(l) 

Subscrip^ 



This would be said: A sub 1. A subscripted variable consists of a letter 
followed by a subscript enclosed within parentheses. Pease note the 

dIfferencB bet^Aeen A, A1, and A(l), Each is unique. Orly A(1) is ta 
subscripted vuriuble. 

Subscripted variables, like simple variables^ name a memory lo<:Qtic>n 
within the computer. Think of subscripted vcriables as boxes to store 

informntj^n^ jiisr Slkia (pimple variables: 



A(0) L 
A(l) 

A(2) ,_ 
A(3) 
A(4) 



It you wrote: 

10 A(^) = 25: A(3) = 55 : A(4) -- -45.3 
Then memory would look like thts; 



A(0) 

A(l) 
A(2) 
A(3) 
AW 



25 



55 



-45.3 



This group of subscripted variobles is also called an array. In thii 
case, n onp-Himenj;iornl nrrny. Lritsr on, \a/s'I intmdure multidinnen- 
siona] arrays. 

Subscripts can also be more complex to Include other variables, or 
computations. T^e following ore valid subscripted variables: 

A(X) A(X+1) A(2+l) A.;]' 3) 

The expressions within the porenrheses are evaluated according to the 
same rules for arrthmetlc operations outlined in Chapter 2. 
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Now that the ground rules are in place, how can subscrioted vari- 
ables be pLt to use? One way is to store a list of numbers entereo with 
INPUT or READ statemenfE. 

Let's use subscripted variables to do the averages a different way. 



5 PRINT CHR*<147> 

le INPUT "HOW MflHV r+UPfBERS ! ■ ?K 

£6 FOR ft = I TO :■ 

30 PRIHT "ENTER '-mUJE # "ffl^ilHFVT B<fi> 

4e NEWT 

50 SU ^ 

Se FOR ft = 1 TO X ~ 

re su ^ su t B<fl) 

30 HEK7 ■' 

95 PRINT ! PRINT "flVERflCE = " ,- SU/i«; 



htON MRMV HUMBERE 
ENTER VRLUE # 1 
EMTER VFlLUE tf 2 
ENTER VRLUE tt 3 
ENTER VRLUE # 4 
ENTER VALUE # 5 

RVERfl&E = iei.2 



There might have beer on easier vjay to accomplish what \ve cfid in 
*hi5 program, but it illustrates how subscripted /ariables wor<. Line 10 
osks for how many numbers will be entered. This variable, X, acts as 
The counter for tfie loop within which values are entered and assigned to 
the eubecrip+ed voi-ioble, B. 

Each time through the INPUT loop, A is increased by ) and so 'he next 
value entared is assigned to the next element in the array A. For excm- 
ple, the first time tlirough the loop A = 1, so the first value entered 
is assigned tc B(l). The riext time through, A = 2; the next value is 
assigned to B(2), and so on until all the values huve been entered. 

But now a big difference comes into p\ay. Once all the values hove 
been entered, they ore stored in the array, ready to be put to work in a 
variety of ways. Before, you kept o running total each tinne throjgh the 
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INPUT or READ loop, but never could get back the indiv'dual pieces of 
dato withoLTt re-reading the informction , 

In lin«3 50 ^hrough 80^ anothei' loop has b^en designed to add up the 
various elernents of the array and then display the average. This seoa- 
rate port of the program shov/s that oil o' the values are stored and con 
be accessed as needed. 

To prove thgt all of the individual volues ore octLoily stored seporo-ely 
in an array, type the following rmmedioteiy at^er running the previous 
program: 

FOR A = 1 TO 5 : ?B(A),: NEXT 

125 167 189 167 

158 

The display will show your actual volues as the contents of the array 
are PRINTed. 

DIMENSION 

If you tried to enter more than 10 nurribcro in the previous example, 
you got a DIMENSION ERROR. Arrayt cf i/p to eleven elements (sub- 
scripts to 10 for a one-dimensional array) may be used where needsd, 
juat as simple variables can be used anyv/here within a program. Arrays 
of more than eleven elements need to be "declored" in a dimenaion 
Statement. 

Add this lire to the program; 

5 DIM B(100) 

This lets the computer know that you will have a maxfmum of 100 
elements in the array. 

The dimensinn stotement ma^ also be used with a variable, so thp 
folfov^ing line could replace line £ (don't forget to eliminate line 5); 

}5 DIM B(X) 

This woj'd dimension the array with the exact number of values that 

will be entered. 

Be careful. Though. Once dimensioned, on array cannot be redimen- 
sloned in another part of the program. You can, however, have nuitlple 
arrays withfn the program and dimension then all on the same line, lika 
Ihis: 

T0 DIM C(20), D{50>, E(40) 
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SIMULATED DICE ROLL WITH ARRAYS 

As programs become more complex, using subscripted variables will 
cut down on the number of statements needed, and make the program 
simpler to write. 

A single subscripted varioble can be used, for example, to keep track 
of the number of times o particular face turns up: 

1 REM DICE SII1ULHTI0N ! PRINT CHRf:C147J 

10 IhFUT "HOW nHNV KULLSS".;X 

20 FOR L = 1 lU X 

30 R - IHTC6*Rr>IDCll J + 1 

40 FCRiJ = FCR^ + 1 

50 NEXT L 

60 PRINT "FfiCE", "NUMBER OF TIMES" 

70 FOR C = 1 70 & : PRINT C. FtL:j»: NEXT 

The array F, for FACE, will be used to keep track of how many tines a 
pnrticular face- turns up. For example, every 'tinne a 2 is thrown, F(2) is 
increased b/ one. By using the same element of 'he orray to hold the 
acluQJ riLimber on the face that is thrown, we've eliminated *he reed for 
five other variables [one for each face) and numerous statenTients to 
check and see v/hat number is throv/n. 

Line 10 asks for hovif many rolls you vuant "o simulate. 

Line 20 establishes the loop to perform the random roll and increment 
the proper element of the array by one each for each toss. 

After all of the required tosses are completed, line 60 PRINTs the 
hectding and line 70 PRINTs the number of times each face shows up. 

A sample run might look like this: 



HOkl MftNV ROLLS 


s '> leee 




FRCE 


HLIMBER 


OF TIMES 


1 


i4S 




2 


17C 1 


3 


178 




4 


lee 




5 


163 




^ 


ie9 ! 











'/fell,, at least 11 wasn't loaded! 

Just as a comparisan, the following is one way of re-writing the same 
program, but without using subscripted variables. Don't bother to type it 

in, bjt do notirp thn additional statements necessary. 
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le INPUT "HOW MRHV ROLLS!'- 

26 FOR L = 1 TO X 

3e R = INT';6*f?ND<:i>>+l 

40 IF R = 1 THEN Fl = Fl + 

41 IF R = £ THEN F2 = F2 + 

42 IF R = 3 THEN F3 = F3 + 

43 IF R = 4 THEN F4 = F4 + 

44 IF R = 5 THEN F5 = F5 + _ 

45 IF R = S THEN F6 = PS + 1 . .._ 
60 PRINT "FflCE"^ "NUMBER OF TIMES 

70 PRINT 1, Fl 

71 PRINT 2, F2 

72 PRINT 3, F3 

73 PRINT 4, F4 

74 PRINT 5, F5 

75 PRINT 6, F6 



jX 



NEXT 

nen;t 

NEXT 
NEXT 
HEWT 



The program has doubled in size fronn 8 to 1 6 lines. In larger pro- 
grami Ihe spcce savings from Lsirrg subscripted variables will be e/en 
more tframaTic. 



TWO-DIMENSIONAL ARRAYS 

Earlier in this chapter you experimented with one-dimensbncil arrays. 
Thii type ai nrray v/cts visualized as a group of consecutive boxes within 
nfiemory each holding on eiftn-eiit of itie array. What would you expect 
o twc-dirrensional array to look like? 

First, a tiA'o-dlmensional array would be ^I'msn like this; 

A(4,6) 
tt 

5U&5C;RIPT5 
iRRAY NAME 

anc could be represented as a -wo-dimensional grid v/it^«in me-nory: 




1 

2 
3 
4 

The subscripts could be thought of as representing the row and col- 
umn within the table where the particular element O' the array is stored. 



g 1 2 3 4 5 6 



100 



Ar3,4) = 255 

T — COLLMN 



■^ 


1 


2 


3 


4 


5 


6 
















































255 



















1 

2 
3 
4 

If we assigned the value 255 to A(3,4), then 255 couid be thought of 
as being placed in the 4th column of the 3rd row within the table. 

Tvi^o-dimensicfnal arrays behovs according to the same rules thof were 
establislied fur one-dirnerisiuritil urruys; 



TKey must be dinensiored; 

Assignment of data: 

Ass'gn valjes to other variables: 

PRINT values: 



DIM A(20,20) 
A(l,l) = 255 
AB = A(1J) 
PRINT A(1J) 



If two-dimensional arrays work like their smaller cDonterparts, what 
additional copabilitcs will the expanded arrays handle? 

Try this: can you think Df a way using a t'A'o-dimensional array to 
tabulate the results of a questionnaire for your club that involved four 
questions and had up to three resporses for each question? The prob- 
lem could be represented like this: 

CLUB QUESTIOINNAIRE 

Ql: ARE YOU IN FAVOR OF RESOLUTION #1? 

□ l-res □2-NO n3-UNDECIDED 

. . . and so on. 
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ihe array table for this problem could be represented like this: 



YES 



RESPONSES 

NO UNDECIDED 



QUESTION 1 
QUESTION 2 
QUESTION 3 
QUESTION A 



The program to do the actual tobitlotion for the questionnaire might 
look like that showr on page 103- 

Thfs progrcm makes use of rTiany of The programming techniques that 
have been presented so far, Even if you don't have any need for the 
actual program right now, see if you can fnllnw how the program 
works. 

The heart of this program is o 4 by 3 two-dimensional orrqy, A(4,3), 
The total responses for each possible answer to each question are held 
in the appropriate element of the array. For the soke of simplicity, v/e 
don't use the rlrst rows and column (A(0,0) to A{0,4)). Remember, 
though, thot those elenents ore always present in any arru/ you design. 

In proctice, if question one is answered YES, then A(l,l) is in- 
crsmented by one — row 1 for question 1 and column 1 for o YES re- 
sponse. The rest of the questions ond answers follow the same pattern. 
A NO response for question three would odd one to element A(3,2), and 
so on. 
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Lte PRINT 



2:0 PRINT "{CLR/HOME}" 
3S FOR R = 1 TO 4 
40 FRIHT "QUESTION # : "; R 
50 FRIHT •■ 1-VES 2-HO 3-LIHDECIDED" 
60 PRINT "WHaT WAS THE RESPOUSE s " f 
6t GET C : IF C <1 or- C>3 THEN SI 
65 PRINT C: PRINT 

re fi<R,C> = fltR^C? + 1: REM LIPDOTE ELEMENT 
Se HENT R 
B5 FRIHT 

50 PRINT "DO VOU WANT TO ENTER ANOTHER" I PRINT 
"RESPONSE CV/N>"; 

iee GET fl* i IF ft* ^ "■■ THEN leo 

r 10 IF fl* = "Y" THEH 28 

:S20 IF ft* O "H" THEH 100 

130 PRINT 'MCLR^HONE )■■;•■ THE TOTFtL RESPONSES 

WERE;":PRINT 
1-10 PRINT SPEC 185; "RESPONSE" 
141 PRINT "QUESTION", '■VES"^"NO","UHDECIDED" 

112 PRINT " 

150 FOR R = 1 TO 4 

160 PRINT R, R<:Rj.1>, fi<:R,2>, fl<:R,3> 

170 NEXT R 

RUN i 

QUESTION « : 1 

1-VES 2-HO 3-UHDECIDEO 

WHHT WAS THE RESPONSE : 1 

QUESTION ♦• : 2 

1-VE3 2-NO 3-UHDEClDED ' 

WHfiT HFiS THE RESPONSE : 1 

Rnd fo Qn. . . 

THE TOTRL RESPONSES WERE; 

RESPONSE 
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INTRODUCTrON 

Now thot you've become more intimately involved with your Commo- 
dore ftA, we vuCint you io know tKot our customer support does not stop 
here. You may not know it, but Connmodore has been in business fur 
over 23 years, ir the 1970's we introduced the fir^t self-contained per- 
sonctl computer (fhe PET). We have since become the leading computer 
company in many countries of the world. Our obilihy to design and 
manufacture our own computer chips allows us to bring you r»ew and 
betrer per&onal computer* at prices woy below whot you'd expect for 
this level of technical excellence. 

Commodore is cornmHted to supporting not only you, ths? p-nd user, 
but also the d»aier you bought your computer from, magozines vs/hich 
publish how-ta articles shovving you nev/ applications or techniques, 
and . . , importantly . . . software developers lA/ho produce programs 
on cartridge, disk and tape for use witfi your computer. We encotiroge 
you to establish or join a Commodore "user club" where you con learn 
nev/ techniques, extlnynge ideas and share discoveries. We publish two 
separate mogazines which contain programming tips, informotton on 
new products and ideas lor computer applicotions. (See Appendix N). 

In Worth America, Commodore provides a "Commodore Information 
Network" on tfie CompuServe Information Service . . . lu access this 
network, all you need is your Commodore 64 computer and our low cost 
VICMODEM telephone interface cartridge (or other compatible modem). 

The following APPENDICES contciin charts, tables, and other irfornna- 
tion which help you program your Commodore 64 faster end more 
efficiently. They also include imporfant information on the wide variety 
of Commodore products you may foe interested in, and o bibliogrophy 
lifting of oi/er 20 books ond mogozines vifhieti can help you develop your 
progrommJng skills and keep you current an the latest information con- 
cernincf your computer and peripherals. 
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APPENDIX A 



COMMODORE 64 ACCESSORIES 
AND SOFTWARE 



ACCESSORIES 

The Commodore 64 wlfl support Commodore VIC 20 storage devices 
and accessories — DAI ASSEI IE recorder, disk drive, modem, printer — 
so your system can expand to keep pace with changing needs. 

• Dotosette Recorder — This lowi cos+tcipe unit enobles pr-ograms and 
dota to be stored on cossette tape, and pigyed back at a later 
rime. The dotdsette can also be used to play pre-wriJten programs. 

• Disk — The single disk unit uses standard 5V4-inch floppy diskettes, 
about the size of a 45 RPM record, to store progroms and dato. 
Disks oilow faster accees to data and hold up io 170,000 char- 
actefs of iriforrnotion each. Disk units are "Intelligent," meaning 
they hove their own microprocessor and memory. Disks require no 
resources from the Commodore 64, such as using part of main 
memor/. 

• Modem — A low-cost communication device, the VICMODEM allows 
access to other computers over Drdinary telephone lines. Users will 
have access to the full resources of large data boses such as The 
Source, CompuSert/e, and Dow Jones News Retrieval Service (North 
Am^ricci only), 

• Printer — The VIC printer produces printed copies of programs, 
data, or graphics. This 30 character per second dot-matrix printer 
uses plain tractor feed paper and ofher inexpensive supplies. The 
print&r ottaehes directly to the Commod^ire 64 without any addi- 
tional Int«rfoces. 

• fnterfflce Cartridges — A number of specialized cartridges vvill be 
available for the Comnnodore 64 to allow various standard devices 
such as modems, printers, controllers, end Instruments to be at- 
tached to the system. 
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with a special lEEE-488 Cartridge, the Commodore 64 will support 
the full range of CBM peripherals including disk units and printers. 

Addirionaily, □ Z60 cartridge will allow you to run CP/JV\* on rhe 
Commodore 64, giving you access to the largest base of 
microcomputer applications available. 



SOFTWARE 

Several categories of software will be offered for the CommotJore 64, 
providing you with a wide variety of personal, entertain rrent, and edu- 
cotlortal applications to choose from. 

BUSINESS AIDS 

• An Electronic Spreadsheet packoge will allow you to plan budgets, 
and perform "v/hat if?" analysis. And with the aptionol graphic 
program, meaningful graphs may be created from the spreadsheet 
data. 

• Financial planning, luch as loon amortization, will be eosily han- 
dled with the Financial Planning Packcge. 

• A number of Professional Time Management programs will help 
manage appointments and \A'ork lood. 

• Easy-to-use Data Base programs will albv/ you to keep track of 
information , . . mailing lists . . . phone lists . . . inventories . . . 
and organiie informatior in a useful form. 

• Professional Vtord Processing programs will turn the Commodore 64 
into □ fuil-featured '//ore processor. Taping and revising memos, 
letters, and other text material become a breeze. 

ENTERTAINMENT 

• The highest quality games ^A/ill be available cm plug-in cartridges 
for the Commodore 64, providing hours of eijcymeit. These pro- 
grams fnake use of the high resolution graphics and full sound 
range possible with the Commodore 64, 

• Your Commodore 64 allows you oil the fun ond excitement avail- 
able or WAX gomes because these two machines hove completely 
compatible cartridges. 



*CP/M is Q 'Esistered trademark of Digital Resegreh 
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EDUCATION 



The Commodore 64 is a tutor that never tires and always gives 
psrEonal attentfon. Besides access ^o mucii of the vast PET educa- 
ttonal programs, additional educational languages that wMI be 
available for the CDmrr.odore 64 include PILOT, LOGO and other 
key advanced packages. 
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APPENDIX B 



ADVANCED CASSETTE OPERATION 



Besides saving copies of your programs on tape, the CoTimodore 64 

CCifi ofso stoi*9 tile values &f variables and &tiier items of data ^ in a 
group calfed a FILE. Tiifs ullov/syuu tu store evsri rnurtj Inforrntjiitiri tliun 
cojld be held in the computer's moiri memory at one time. 

Statements used v/ith data files are OPEN, CLOSE, PRINT*, INPUT*, 

and GET#. The system variable ST (status) i£ used to check lof tape 
mcirkers. 

In writing data to tape, the same coricepts are used as when disploy- 
ing information on the computer's screen. But instead of PRINTing in- 
formntior on the screen, the informn+ion is PRINTed on tapt* using a 
variation of the PRINT command — Pf!INT#. 

The following program illustrates how this works; 



10 PRINT "WRITE-TO-TRPE-PROGRflri" 

20 OPEN l,l.J,"DfiTfl FILE" 

30 PRINT "TVPE DflTfl TO BE STORED OR TVPE STOP" 

50 PRINT 

S0 IKPUT ••OPTfl";P* 

72 PfJIHT #1, ft* 

Se IF R^ <>"STOP" THEN 50 

98 PRINT 

100 PRINT "CLOSING FILE" 

110 CLOSE 1 



The first thitig that you musi do is OPEN a file (in this cose DATA FILE). 
Line 10 hordles that. 

The progrom promp-s for the dpta you want to save on tope in line 

60. Line 70 writes what you Typed — held in A? — onto the tope. And the 
process continues. 

if i-ou type STOP, lire 1 10 CLOSES the file. 
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To retrieve the information, rewind the tape, cind try this: 



10 PFirHT "REftD-ThlPE-PROnRflM" 

£0 OPEN 1. l.re,"DRTft FILE" 

30 PRINT "FILE OPEN" 

40 PRINT 

50 IHPUT#1 , H* 

50 PRINT fl* 

70 ir n* - "STOP" TUCH END 

30 GOTO 40 



Again, the file "DATA FILE" first muar be OPENed. In line 50 Ine pro- 
grarr INPUTS A$ from tope and also PRINTS A$ on the screen. Then the 
whole process Is repeated until "STOP" is found, which ENDs the p^o- 
grcirr. 

A variation of OET — CET# — can also be used to read the data back 
from tope. Replace lines 50-80 in the arogrom above with; 



50 GETttl. R* 

60 IF R* = "" THEN END 

70 PRINT ft*.. r\Gcxn*> 

80 GOTO 50 
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APPENDIX C 



COMMODORE 64 BASIC 



This manual has given you an introduction to the BASIC language — 
enough for you to get a feel for computer programming and some of 
the vocabulary involved. This appendix gives a complete list of the rules 
(SYNTAX) of Commodore 64 BASIC, alurig with concise descripTions, 
Please experiment with these commands. Remember^ /ou can't do any 
permanent damage to +he computer by [ust typing in programs, and the 
best way to learn computing !<; by doing. 

This opoendlx is divided into sections occording to the different types 
of operations in BASIC. These Include: 

1. Variables and Operators: describes the different type of variables, 
legal variaole rames, and arithmetic and logical operators. 

2. Commands: describes tiie eonnmiands used to work witK programs, 
edit, store, and erase them. 

3. Statements; describes the BASIC program statements used in num- 
bered lines of programs. 

4. Functions: describes the string, numeric, and print functions. 



VARIABLES 

The Commodore 64 uses three types of variables in BASIC. These ore 
real numeric, integer numeric, end string (alphanjrfieric) variables. 

Variable rames may consist of a single letter, o letter followed by a 
number, or two letters. 

An integer variable is specified by using the percent (%) sign ofter the 
variable name. String variables have the dollar sign [$) ofter their 
name. 

EXAMPLES 

Reol Variable Names: A, A5, BZ 

Integer Voriable Names: A%, A5%, BZ% 
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String Variable Names: A$, A5%, BZS 

Arroys ore lists of variables with the scime namej using extro numbers 
to specify the element of the array. Arrays are defiled using the DIM 
statement, and may contain floating point, integer, or string variables. 
The orray variable name is followed by a set of parentheses ( ) enclos- 
ing the number of variables in the list. 

A(7), B2%(n), A$(50), PT(20,20) 

MOTE: There are three variable names whici ore reserved for use by 
tfie Commottor© 6A, and may not be defin&d by you. These voriabies 
are: ST, Ti, and Tl$. ST is o status variable which relates to input/output 
Operations. The value of ST will change if there is a problem loading a 
program ^rom disk or tope, 

TI and Tl$ ore variables which relate to the real-time clock built into 
the Commodore 64, The variable TI is updated every Visoth of a second. 
\f starts at when the computer is turned on, and is reset only by chang- 
ing the value of Tl$, 

Tl$ is a string Vi^hich is corstantly updated by the system. The first two 
characters contain the number of hours, the 3rd and 4th cliorocters the 
number of minutes, and the 5th and 6lh characters are thti number of 
seconds. This variable can be given any numeric valje, and will be 
updated from that point. 

Tt$ - "101 £30" sets the clock to 10:15 and, 30 seconds AM. 

This clock is erased when the computer s turned off, and starts at 
zero when the system is turned back on. 

OPERATORS 

The orithmetic operators include the foilowing signs; 

+ Addition 
— Subtraction 
* Multiplication 

/ Division 

"f Raising to a power (exponentiation) 

On o line containing more than one operator, there is a set order in 
vi/hich nperaticns always occur. If several operationi are used together 
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on the seme line, the compufer ossigns priorhies as follows: First, ex- 
ponentlotion. Next, multiDlication ard division, and lost, addition and 
aubtfacticn . 

Yoj can change the orde' of operalions by enclosing v/itnir pa- 
rentheses the ccJculation to be aerformed first, Operqtions enclosed in 
parentheses will take place before other operations. 

There are also operations for equalities and inequalities: 

= Equal To 

< Less Than 

> Gfeotei- Than 

<= Less Than or Equol To 

>= Greater Thon or Equal To 

<> Not EqucI To 

Finally, there are three logical operators; 

AND 
OR 
NOT 

These ure used iriosi often lo join riulliplts roririultJs in IF . . . THEN 
Statements. For example: 

IF A = B AND C = D THEN 1 00 (Requires both ports to be true) 

IF A = B OR C = D THEN 1 OO (Allows either part to be true) 



COMMANDS 

CONT (ConMnue) 

This comrTiand is u&ed to restart the execution of a pro^'^am ^'hich has 
been stopped by either using the STOP key, a STOP statement, or an 
END itafemertt within the program. The progrom will restortatthe exact 
place from where it left off. 

CONT will rot worl< if you have changec or added lines to the pro- 
gram (or even just moved the cursor), or [f the program halted due to an 
error, or if you caused an error before trymg to restart the progrcm. In 
these cases you will get a CAN'T CONTINUE ERROR. 
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LIST 

The LIST command allows you to look cit lines of a BASiC program in 
memory. You can ask for the entire pr'o^rcim to be dEaplayed, or only 

certain line numbers. 

LIST Shows entire program 

LIST 10 — Shovy^ ^nly -from line 10 until end 

LIST 10 Shows only Ifne 10 

LIST —10 Shows lines from beginning jntil 10 

LIST 10-20 Shows line from 10 to 20, mc\\)t'we 

LOAD 

This command is used 'O transfer a program from tape or disk inlc 
memory so the prcgrann can be used. It you just type LOAD ond hit 
RETURN, the first program found on the cassette unit v/ill be placed in 
memory. The comrrand may be followed by a program name enclosed 
wlttiiri quoles. The name may then be follov,red by a comma and o 
number or njmeric variable, which acts as a device nurnber to indicate 
where the program Is coming from. 

It no de»/ice number is given, the Commodore 64 assumes device #1, 
wtiit;h is the cassette unit. The other device commonly jsed with the 
LOAD command is the disk drive, which is device #8. 

LOAD Reads In tne next program on tcpe 

LOAD "HELLO" Searches tape fc program called 

HELLO, and loods program, if fgtind 
LOAD A$ Looks tor program v/hose name is in the variable A$ 

LOAD "HELL0",8 Looks for program called HELLO on tne disk drfve 
LOAD "*",8 Look& for first program on dlst 

NEW 

This comnrand erases The entire arogrann In memo'y, and also clears 
out any variables that may have been used. Unless the progrcm was 
SAVEo, it is ost. BE CAREFUL WHEN YOU USE THIS COMMAND. 

The NCW command can also be used as a BASIC program statement, 
When the program reaches this I ne, the program is erased. This is use- 
ful if you want to leave everything neat when the program is done. 
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RUN 

This command causes execulion of a pmgrom, once the orogram is 
looded irto memory. If there Is no line number following RUN, fhn torn- 
pLter will stgirT wifli ihe lowest line nLmber. If o lire number is desig- 
nated, the program will sfarl executing from the specified fine. 

RUN Starts program at lowest line nymber 

RUN ]00 Starts execution at line 100 

RUN X UNDEFINED STATEMENT ERROR. Yoj must 

always specify' an actual lirie number, 

not a variable ra presentation 



SAVE 

This toinmarid will slyre the program currently In memory on cassette 
or disk. If you just type SAVE and RETURN, the program will be SAVEd on 
cassette. The computer has no way of knowing if there Is o program 
olrecidy ot thot tope, so be careful with your tapes or you nnay erase a 
valuable program. 

If you t/pe SAVE followed by a nome in quotes or a string varable, 
the computer will give ihe program that name, so it can be more easily 
located and retrieved in the future. The name may aho be followed hy 
a device number. 

After the device number, there can be a comma and a second 
number, either or 1 . I- the second number Is 1 , the Commodore 64 will 
put on END-OF-TAPE marker after your program. This signals tha 
computer not to looJt ony further on the tape if you were to give an 
addiliodol LOAD command. If you try to LOAD a program and the com- 
puter finds one of these markers, you will get a FILE MOT FOUND ER- 
ROR. 

SAVE Stores program to rape without name 

SAVE -HtLLO" Stores on tape with name HELLO 

SAVE AS Stores on tape with name ir A$ 

SAVE "HELLO", 8 Stores or disk with name HELLO 
SAVE "HELLO",],] Stores on -ape with name HELLO 

and follows program wth END-OF- 
TAPE marker 
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VERIFY 

This commond couses the computer to check the program on diik or 
tape agoinst the one in rremorY. Thii is proof that the program is agtu- 
ally Sfii/td, in case the rape or disk is bad, or something went wrong 
during the SAVE- VERfFY v/ithout any+hing ofter the commond causes the 
Commcdore 64 to check the next p'ogram on tape, regardless of name, 

dCfoinst the program In memory. 

VERIFY followed by a program name, or a string variable, will search 
for that program and then check. Device numbe''5 can also be included 
Vi/ith the verify command. 

VERIFY Checks the next program on tape 

VERIFY "HELLO" Secrches for HELLO, checks against memory 

VERIFY "HELLO", 8 Secrches for HELLO on disk, then checks 



STATEMENTS 

CLOSE 

This command completes and closes any files used by OPEN state- 
ments. The number following CLOSE is the file number to be closed. 

CLOSE 2 Ont/ file #2 is closed 



CLR 

This command will erase any variables in memory, but leaves the 
program itself intact. This command is automatically execu'ed when a 
RUN command is given. 

CMO 

CMD sends the output which normally would go to the screen (i.e., 
PRINT statennents, LISTs, but not POKEs onto tfie screen) +□ another de- 
vice instead. This could be a printer, or □ dulu file on lope or disk. This 
device or file must be OPENed first. The C.V\D command mjst be fol- 
lowed by a number or numeric variable referring to the file. 



OPtM 1,4 OPENS device #4, which is the printer 

CMD 1 All normal output now goes to printer 

LIST The program listing now goes to 

the printer, not the screen 

To send output back to the licreen, CLOSE the file with CLOSE 1 . 
DATA 

This statement is followed by a list of items to be Lised by READ 
statements, items may be numeric values or text strings, and items are 
separated by commos. String items need not be Inside quote mQrl<5 
jnless rhey contain space, colon, or comma. If two commas have noth- 
ing bet//een tiem, the value wifl be READ as a zero for a number, or an 
empty string. 

DATA 12, 14.5, "HELLO, MOM", 3.14, PARTI 
DEF FN 

This commond cIIonws you to define a complex colculotlori as a func- 
tion with a short narne. In the case of a long formula that is used mony 
limes within the program, this can save time and space. 

The -unction name vM be FN and any legal variable name (1 or 2 
characters long). First yow must define the function using the Statement 
DEF foiowed by the function name. Following the name is a set of pa- 
reriltieses tjiiclostng <^ nuiTie°"ic variable. Tlien -qIIows the actual formula 
that yoj want to define, with the variable in the proper spot. You can 
then "call" the formula, substituting any number for the variable. 

10 DEF FNA(X) = 12*<34.75 Xj.3) 
20 PRINT FNA(7) 

t 



* j& inierted v.4iers 
.< \i in Ihe 'ofrt'ulo 



Foi ihis eJturiiple, ihe resull would be ]37. 



When yoL use more than 1 1 elements of an array, you must execute u 
DIM statement for -he array, Keep in mind that the whole array takes up 
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fOOiTi in memory! so don't create on array riioth largsr than you'll need. 
To figure the number of variables created with DfM, multiply the totol 
number of elements In each dfmeisior of fhe array, 

10 DIM A$(40h B7(15), CQ%{4,4,4) 

it t 

41 EltM£NTS IS £lEMtNTS lis ELEMEwre 

Vbu CCin dimension mor^ than "on* Qrroy in g DIM stotementt How- 

ever, bs carelul not To dimansion an array more than once. 

END 

Wlier a program encounters an END statement, the prograrii halts, as 
if It rein out of lines. You may use CONT to restart the program. 

FOR. . .TO. . .STEP 

This statement works with the NEXT statement to repeat a sect'oti of 
the program a set njmber of times. The format h: 

FOR (Vor. Name)-(Start of CoLintj TO (End of Count) STEP(Count By) 

The loop variable will be added to or subtracted from during the 
prosrom. Without any STEP specified, STEP Is ossumed to be 1. The start 
count and end count are the limits to the value of the loop variable. 

10 FOR L = 1 TO 10 STEP .1 
20 PRINT L 
30 NEXT L 

The end of the loop value may be followed by the word STEP and 
another number or variable. In this case, the value following STEP is 
added each time instead o^ 1. This allows you to count bockwards, or 

by fractions. 

GET 

The GET statement ollcws you to get data from the keyboard, one 
chorocter at a time. When GET is executed, the chcirdcter that Is typed i^ 
assigned to the variable. If no cfiaratler is typed, then a null (empty) 
chorocter is assigned. 
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GET is folluwtJ by a variab-le nurne^ lisuully o string vciricible. If a 
numeric variable v/as used and a nomumeric key depressed^ the pro- 
gram wojid halt with an error message. The GET slaternent may be 
pieced into a loop, checkirig for any empty result. This loop will continue 
until □ ke/ i* hit. 

10GET A$: IF A$ =""THEN 10 
GET# 

Tbe_QEJ# statement is usee with a previously OPENed device or file, 
to input one character at a time from that device or file. 

GET #1,A$ 

Ihis would Input one character from a data file. 

OOSUB 

This stolemeni is similar to GOTO, except the compuTer remembers 
which program line it last executed before the GOSUB. When a line with 
a RETURN statement is encountered, the program jumps back to the 
stotement immediately following the GOSUB. This is useful if there is a 
rojtinti in yuur pioyruin !liuf occurs in 5e\*erul purls of ttie progrom. 
hsteod of t>'ping the routine over and over, execufe GOSUBs ecch time 
the routine is needed. 

20 GOSUB 800 

GOTO OR GO TO 

When a statement wlfh the GOTO command is reached, the rext line 
to be executed will be -he one with the line number following the word 
GOTO. 

IF. . .THEN 

IF. . THEN lets the computer analyze a sitjcition ond take tuuo possi- 
ble cou'ses of octiDn, depending on the outcome. If the expression is 
true, the statement following THEN is executed. This may be any BASIC 
statement, 

It th^ expression is fclse, the program goe& directly^ to the- next line. 

The expreasioii beiny evulutitsd ma/ be a variable or formula, in 
which case it is considered true if nonzero, end false if zero. In most 
coses, there is on expression involving relational operators (=, <, >, 
<=, > = , <>, AND, OR, NOT}. 
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10 IF X > 10 THEN END 

iNPur 

The INPUT statement allo'A^s the program to get data from the user, 
cssigning that data to a variable. The prograrr w/iil stop, print a ques- 
tion mcifk (?) on the scr&sn, and wait for the user to type In ths antwer 
□ nd hit RETURN. 

INPUT l5 followed by a variable name, or a list of variable names, 
separated by commas. A rressage may be placed within quote rriarks, 
befora the \hi of vcriabl© ncimei to be INPUT. If more than on* voriabis 
is to be INPUT, ihey ri)ust be sepuratssd by corrrnas when typed. 

10 INPUT "PLEASE ENTER YOUR FIRST NAME ';A$ 
20 PRINT "ENTER YOUR CODE NUMBER"; r INPUT R 

INPUT* 

INPUT# 13 similar to INPUT, but takes data from a previously OPENed 
file or device. 

10 INPUT#1, A 

LET 

LET is hardly evsr used in programs, since it is optional, out 'he 
s'atenent h the heart of all BASIC progrcms. The i/ariable name which 
is to be assgned the result of a calculation is or the left side of the 
equal sign, and the formulc on the right. 

10 LET A - 5 

20 LET D$ = "HELLO" 

NEXT 

NEXT is always used n conjunction with the FOR statemert. When the 
pfogram reaches a NEXT statement, it checks the FOR stotement to see 
if the limit of the loop has been reached. If the loop is not finished, *he 
loop variable is increoied by the specified STEP value. If the loop is 
ftnished, execution proceeds with the statement foilowinc NEXT. 
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NEXT ma/ be followed by a variable name, or list of variable names, 
separated by commas. If there are no names listed, rhe last loop started 
is the one being completed. If variablf><i ore given, they are cornpleted 
in order from left to right, 

10 FOR X = I TO 100: NEXT 
ON 

This command turns the GOTO and GOSUB commands into special 
versions of the IF statement. ON is followed by a fnrmuia, wliich is 
evaluated. If the result of the colcylation is one, the first line on the list is 
executed; if the 'esuir is 2, the second line is executed, and so on. tf the 
result is 0, negative, or larger than the list of numbers, the next line 
executed will be the statement following the ON statement. 

10 INPUT X 

20 ON X GOTO 10,20,32, 40,50 

OPEN 

The OPEN statement allows the Commodore 64 to access devices such 
as l-he cassette recorder and disk for data, a printer, or even tne screen. 
OPEN is followed by a r^umber (0-255), to which all following statements 
will refer. There is usually a second number offer the first, which is the 
device number. 

The device numbers ore: 

Screen 

1 Cassette 
4 Prin'er 

6 Disk 

Followiriy the device riumber may be a Third number, separated 
again by a comma, which h the secondary address. Ir the cose of l-he 
casserte, this is for read, 1 for write, and 2 for write with erd-of-tope 

mark«c. 

In ifie case of the disk, the number refers to the buffer, or channel, 
number. In the printer, the secondary address controls features like ex- 
panded printing. See the Commodore 64 Programmer's Reference Man- 
ual for mor^ detc}il&. 
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10 OPEN 1,0 OPENS The SCREEN as a device 

20 OPEN 2,1,0,"D" OPENS the cassette for reading, 

file to be searched for is D 
30 OPEN 3,4 OPENS the printer 

40 OPEN 4,8,15 OPENS the data channel on rhe disk 

AIsc see: CLOSE, CMD, GET#, INPUT#, ard PRtNT#, system variable 

ST, and Appendix B* 

POKE 

POKE ie dlwcys followec^ by tv/o numbers, or forrrtuloi. The fifst loca- 
tion is a memory location; the second number is a uecirTitil value from 
to 255, which will be placed in the memory bcation, replacing any pre- 
viously stored value. 

10 POKE 53281,0 

2J3 S=4096*13 
3fl POKE S+29,8 

PRINT 

The PRINT statement is the first one most people leatn to use, but 
there are a number of variations to be awore of. PRINT can be follo\A/9d 
by; 

Text String with quotes 
Variable names 
Functions 
Punctuation morks 

Punctuation marks are used to help formnt the data on the screen. 
The cornrriLi divides the screen into four colunna, while the semicolon 
suppresses all spacing. Either mark can be the last symbol on a tire. 
This results in the next thing PRINTed acting as if it were a continuation 

of the Sonne PRINT statement. 

10 PRINT "HELLO" 
20 PRINT "HELLO". A$ 
30 PRINT A+B 
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40 PRINT J; 

60 PRINT A,B,C,D 

Also see: POS, SPC cind TAB functigns 

PRINT* 

Thera are a few differences betwssn -this sta+enent and PRIWT. 
PRINT# 13 followed by <a number, whith -efeii tu ihe devita or duta file 
previously OPENed. This number is followed by a comma and a list to be 
printed. The comma and semicolon have the same effect as they do "n 
PRINT. PIsass note that some devices mciy net work with TAB and SPC. 

\00 PRINTS 1, "DATA VALUES"; A%, Bl, C$ 

READ 

READ is used to assign information from DATA statements to vari- 
ables, so the informatiuii rriuy be put lo use. Care must be raken to 
ovoid READing strings where READ is expecting a number, which will 
give a TYPE AIISMATCH ERROR. 

REM (Remark) 

REMark is a note to whomever is reading a LIST of tie progrom. It 
may explain a section of the program, or give additionai instructions. 
REM statements in no way af-ect the operation of the program, except 
to add to itj length. REM may be followed by any text. 

RESTORE 

When executed in a program, the pointer to which an item in a DATA 
statement Wiil! be READ next is rBSet to tlie first item in lhe ll^t. This give? 
you the ability to re-READ the information. RESTORE stands by itself on a 
line. 

RETURN 

This statcnont 's olways used in coniunction with COSUB. When ths 
program en:ounrers a RETLRN, it will go to the statement immedia-ely 
following the GOSUB command. If no GOSUB was previously issued, a 
RETURN Vi^lTHDUT GOSUB ERROR will orrur. 
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STOP 

This statonnent will halt program execution. The messoge, BREAK IN 
7Q<.x.Wt\\ be displayed, where xxa is the line nuruber containing STOP. "!^he 
program may be restarted oy using the CONT command, STOP is nor- 
mally used in debugging a program, 

SYS 

SYS is followed by a decimal number or numeric value in the range 
0-65535. *h(i prngram wii! then begin executing the tTbOchine languoge 
progrcam storting ot that memory locotion. This is similar to the USR 
function, but does not allow parameter passing. 

WAIT 

WAIT is used to halt the progrorr* until the contents of a memory loca- 
tion change; in a specific way. WAIT is followed by a memory location 
(X) and up to two variables. The format is: 

WAIT X,Y,Z 

The contents of tie rrismory location are first exclusive-ORed with the 
third number, if present, and then logicaily ANDed lA/ith the second 
number. If th* result is zero, the program gofti back to thai- memory 
location and checks again. When the result is nonzero. The program 
continues wil^h the next statemient. 



NUMERIC FUNCTIONS 

ABS(X) {cib»lute value) I 

ABS returns the absolute value of fhe number, without its sign i+ or 
— ). The answer is always positive, 

ATN(X> (arcfongent) 

Returns the argle, mecsured in radians, whose tangent is X. 
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COS(X) (<«$ine) 

Returns the value of the cosine of X, where X is an angle measured In 
radians. 

EXP(X) 

ReturriE the voius of the mothemoKcol eon?teint e(2, 71 327183) raised 
to th$ power of X, 

FNxx(X) 

Re-urns the value of the user-defined function xx created In a DEF 
FNxx^X) $toter-fient, 

INT(X) 

Returns the truncated value of X, that is, v*,'ith all the decimal places 
to the right of the decimal point removed. The result will always be less 
than, or equai to, X. Thus, any negative numbers v^ith decimal places 
will become the integer less than their current value. 

10«(X) (logarithm) 

Will retjrn the natural log of X. The natural log to the base e (see 
EXP(X)). To convert to bg base 10, simply divide by LOG(IO). 

PEEK(X) 

Used to find out contents of memory location X, in the range 0-65535, 
giving a result from 0-255. PEEK is often used fn conjunction v/iti the 
POKE statement. 

RND(X) (rcind«m number) 

RND(X) returns a random number in the range 0-1. The first random 
nomber should be generated by -he formula RMD(— Tl) to stcrt things off 
differently every time. After this, X should bo a 1 or any positive 
number. If X Is zero, the result will be the same random number as the 
last one. 
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A negative value for X will reseed the generator. The use oi the same 
negative number for X will result in the same sequence of "randcm" 
numbers. 

The -formula for generating a number between X ond V is; 

N = RND(1)'CY-X)+X 

where, 

y is the 'Upper lim't 

X is the lower range of numbers desired. 

SGN[X) (sign) 

This fundion returns the sign (positive, negative, or zero) of X. The 
result will be + 1 if positive, if zero, and —1 if negative, 

SIN(X) (sine) 

SIN(X) is the trigorometric sine function. The result will be the sine of 
X, Vi/here X \^ cin nngle in radians. 

SQR(X} (sqvare root) 

This function will return the square root of X, where X is a positive 
number or 0. If X is negative, an IL.EGAL QUANTITY ERROR results. 

TAN(X) (tangent) 

The result will be the tongent of X, where X is an angia in radians. 

USRCX) 

when this function is used, the program jumps to a machine langucge 
program whose starting point is contained in memory locations. The pa- 
rameter X is passed to the machine language program, which will re- 
turn another value beck to the BASIC program. Refer to the Commodore 

64 Pfogromnner's Refersnce Manual for more details on this function 
and machine language programming. 



1» 



STRING FUNCTIONS 

ASC{X$) 

This function will r<itLfn the ASCII code of the frs' chaigcfer of X$. 

CHR$(X> 

This is the opposite of ASC, and returns string chgracler whose 
ASCII code is X. 

tEFr${X$,X) 

Returns a string ccntaining the leftmost X characters of $?<. 
LEN(X$) 

Refurned will be the number of characters (including spaces and 
other symbols) ir the string X$. 

miD$(x$,s,x) 

This \>ji\' return a string containing X charactors starting from the Sth 
character in X$. 

RIGHr$(X$,X) 

Retuns the rightmost X choracters In X$. 
STH${X) 

This will return o String which is identical to the PRINTed version of X. 
WL(X$) 

This function converts X$ into a number, and is essantiolly the inverse 
operation from 3TR5. The string h examined from the leftmost character 
to the nght, for cs many characters as are in recognizoble number for- 
mat. 
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10 X = VAL("123.456'') X = ^'>^A5^ 

10 X - VAL("12A13B") X = 12 

1^ X = VAL("R[U017") X = 

^0 X = VAL ("-1.23.45.67") X = -1.23 



OTHER FUNCTIONS 

FRE(X) 

This function returns tlie number cf unused bytes avaitable in memory, 
regardless of tKe value of X. No"e that FRE(X) will read out n negative 
nurrbers if The number of unused bytes is over 32IC. 

POS{X) 

This function returns the rumber of the column (0-39) at v/hich the 
next PRINT statement will begin on the screen. X moy hove ony volue 
and is not used. 

SI>C[X) 

This is used in a PRINT sfatemant to skip X spaces forward. 

TAB(X) 

TAB is also used in a PRINT statement; the next tern to be PRINTed will 
be in colunn X. 
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APPENDIX D 



ABBREVIATIONS FOR 
BASIC KEYWORDS 



As a lime-EQver when typing in programs and commands, Commo- 
dor& 64 BASIC dlJov/£ the usor to abbrsviat* most Iceyvj'crds. Th© ab- 
breviation for PRINT is a question mark. Tine abbreviations for other 
words are mode by typing the first one or two letters of the word, fol- 
lowed by the SHIFTed next letter of the word. If the abbreviations are 
used ir a program Ifne, the keyword will LIST in the full form. 



Com- 
mand 


Abbr«vi. 


thi* on 


Com- 
mand 


Abbravi- 
ation 


looks like 
this on 
*cr**n 


ABS 


A ■i!^\yif B 


A 


END 


E gniBi N 


E L^ 


AND 


A ^^P N 


a/ 


EXP 


E SQQI X 


E (♦! 


ASC 


A ^^Q S 


A V 


FN 


NONE 


FN 


ATN 


A ^^Q T 


-f 


hOR 


f- f!n|| u 


^ n 


CHR$ 


C ^^ H 


cH 


FRE 


F ^^Q R 


F 


CLOSE 


CL^^] O 


clH 


GET 


G ^^9 E 


G 


CLR 


C ^^] L 


^D 


GET* 


NONE 


GET# 


CMD 


C ^^3 ^ 


-N 


GOSUB 


GO^Q.^ 


GO V 


CONT 


c ^^3 o 


en 


GOTO 


G BilM o 


G n 


COS 


NONE 


cos 


IF 


NONE 


IF 


DATA 


D ^gim A 


Dl^l 


IMPUT 


NONE 


INPUT 


DEF 


Igjim E 


D ~" 


INPUT* 


1 Q2Q3I N 


' /I 


Dim 


D QQ 1 


D ^ 


INT 


NONE 


INT 



1^0 







Lgoks like 






Looks liks 


Com- 


Abbrevi- 


this an 


Com- 


Abbrevi- 


this on 


nriand 


cition 


scree n 


mand 


ation 


screen 


LEFT$ 


-E ^^Q 1= 


-E 


RIGHTS 


R BTIBl 1 


^Q 


LEN 


NONE 


.EN 


RND 


R Bnia H 


R^ 


LET 


. BBig E 


L 1 


RUN 


R E!IB| U 


H/J 


LIST 


L Qjm 1 


lQ 


SAVE 


sBTma A 


M*J 


LOAD 


L B!IB| Q 


^n 


SGN 


s Bffliy G 


5 


LOG 


NONE 


LOC 


SIN 


s ^031 < 


= bJ 


WID$ 


^^Q|3 1 


M>, 


SPC( 


s ^^Q p 


^n 


(JEW 


NONE 


NEW 


SQR 


S ^^Q Q 


^m 


NEXT 


N Effini E 


N n 


STATUS 


ST 


ST 


NOT 


N ^iJII 


N| 1 


STEP 


stEJIBI e 


ST^ 


ON 


NONE 


ON 


STOP 




5 


OPEN 


O^^Q P 


oH 


STR$ 


3T 0^3 R 


3T^ 


OR 


NONE 


OH 


SYS 


S ^^3 Y 


^ 1 


PEEK 


P yjlil E 




TAB( 


T ^jl A 


T 4 


POKE 


P ^^Q 


^n 


TAN 


NONE 


TAN 


POS 


NONE 


POS 


THEN 


T E33 H 


tR 


PRINT 


f 


? 


TIME 


Tl 


TI 


PRINT* 


p ^gm R 


^ -J 


iimES 


Tli 


Tl$ 


READ 


R Bfiin E 


R — 


J5R 


u BQ3I $ 


u |V 


REM 


NONE 


REM 


VAL 


V ijum A 


V 4 


RESTORE 


RE ^^9 3 


RFJV 


VERIFY 


V ^^9 E 


V 


RETURN 


RE 0313 T 


^eOD 


WAIT 


WQ|]]3 A 


w|4 
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APPENDIX E 



SCREEN DISPLAY CODES 



The following chart lUts all of the cheircicters built Into the Commodore 
64 character sets. It shows which numbers should be POKEd ii to screen 
mernory {locatons 1024-202J) to get a desired character. Also shown is 
whicK chorocter corresponds to a number PEEKed from the screen. 

l\Mo character Sfits ore avnilable, but only one set at a time. Triis 
meons that you carrot have characters from one aet on the screen at 
the same time you have charocters from the other set displayed. The 
sets are switched by holding down the ^^Q and Q keys smul- 
taneously. 

from BASIC, POKE 53272,21 will switch to upper case mode and 
POKE 53272,23 s\A/itches to lower case. 

An/ nurnber on the chart may also be displayed ii REVERSE. The 
reverse character code may be obtained by adding 128 to the values 
sho%A/n. 

If you want to display a solid circle at location 1504, POKE the code 
for the circle (81) into location 1504: POKE 1504,81. 

There is a corcesponcing memory location to control the color of each 
chororter displayed on the screen (lorntlons 55/'9f>-.5<S9<>5). To chonge 
the color <jf 'he circle to yellow (color code 7) you would POKE the corre- 
sponding memory location (SS^/fi) with the character color: POKE 
55776,7. 

Refer to Appendix G for the complete screen and color memory 
mgps, olong with cobr codes. 



SCREEN CODES 



SET1 


SETZ 


POKE 


sen 


SET 2 


POKE 


SET1 


SETS 


POKE 


@ 







c 





3 


F 


f 


6 


A 


a 


1 


D 


d 


4 


G 


9 


7 


B 


b 


2 


E 


e 


5 


H 


h 


8 
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SET 1 SET Z 


POKE 


SET 1 SET 2 POKE 


SET1 


sera 


POKE 


1 


i 


9 


% 


37 


* 


A 


65 


J 


J 


10 


& 


3Q 




B 


56 


K 


k 


11 


^ 


39 


H 


C 


67 


L 


1 


12 


{ 


40 


^ 


D 


58 


M r 


Tl 


13 


) 


41 


M 


E 


69 


N 


n 


1«t 


* 


42 


1 


P 


70 








15 


+ 


43 


II 


G 


71 


P 


p 


16 


1 


44 




H 


72 


Q 


q 


17 


- 


45 


bJ 


1 


73 


R 


r 


18 




46 


n 


J 


74 


s 


s 


19 


/ 


47 


pr 


K 


75 


T 


t 


20 





48 


□ 


L 


76 


U 


u 


21 


1 


49 


^ 


M 


77 


V 


V 


22 


2 


50 





N 


78 


w 


w 


23 


3 


51 


□ 





79 


X 


X 


24 


4 


52 


n 


P 


80 


Y 


y 


25 


5 


63 


m 


Q 


81 


z 


z 


26 


6 


54 


u 


R 


82 


[ 




27 


7 


55 


V 


S 


83 


E 




28 


8 


56 




T 


84 


] 




29 


3 


57 


r 


U 


85 


t 




30 


: 


58 


^ 


V 


86 


^ 




31 
32 
33 


< 


69 
60 
61 


o 


w 

X 
Y 


87 


I SPACE 


88 


! 


89 


" 




34 


> 


6£ 


II 


z 


90 


# 




35 


? 


63 


ffl 




91 


$ 




36 


■^ 


64 


B 




m 
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SET 1 SET 2 


POKE 


SET1 


SET 2 


POKE 


SET 1 


8ET2 


POKE 


m 




93 


n 


^ 


105 


r 




117 


TT yv 


94 


n 




106 


1 




118 


a I 


S 


95 
96 
97 


L 




107 
10S 
109 


n 
n 




119 


SPftCE 


120 


E 


121 






98 


n 




110 


□ 


v/ 


122 


^ 




99 


u 




111 


k! 




123 






100 


Iri 




112 


n 




124 






101 


_L 




113 


J 




125 


m 




102 


M 




114 


f 1 




126 






103 


H 




115 


Pi 




127 


n 




104 


n 




116 









Codes from 123-255 are reversed Images of codes 0-127. 
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APPENDIX F 



ASCII AND CHR$ CODES 



This oppendfx shows you what characters wtl! appeor if you PRINT 
CHR$(X;, for oil possible values of X. It will also show the values ob- 
toined by typing PRINT ASC("x"), where x Is ony character you can type. 
This is useful in evaluating the character received in a GET statement, 
converting upperflower case, and printing character based commands 
(like swifch to upper/lov.'er case) that could not be enclosed in quotes. 



PRINTS CHR$ 


PRINTS 


CHH» 


PRINTS 


CHR$ 


PRINTS 


CHR$ 





B 


17 


" 


34 


3 


51 


1 


Mk 


18 


# 


35 


4 


52 


2 


Wi 


19 


$ 


36 


5 


53 


3 


H 


20 


% 


37 


6 


54 


4 




21 


& 


38 


7 


55 


^^B 5 




22 


■ 


39 


9 


S6 


6 




23 


( 


40 


9 


57 


7 




24 


) 


41 


: 


58 


DISABLEsQmQS 




25 


* 


42 


; 


59 


EtMBtEs QQJIQs 




26 


+ 


43 


<^ 


60 


10 




27 


, 


44 


= 


61 


11 


m 


28 


- 


45 


3 


62 


12 


m 


29 


■ 


46 


7 


63 


^^^Q 13 


^^Q 


30 

31 
32 


/ 



1 


47 

48 
49 


eg' 

A 
B 


64 
65 
66 


■■imHil'ilia ^M 


VkmiaLtf&m '^ 


15 


16 


J 


33 


2 


50 


C 


67 



13S 



PRINTS 


CHRt 


PRINTS 


CHRJ 


PRINTS CHfW 


{ PRINTS 


CI^RI 


D 


68 


4 


97 


TT 126 


i + 


155 


E 


69 




98 


r^ 127 


A 


156 


F 


70 


h 


99 


128 


H 


157 


G 


71 


^ 


100 


1* 12S 


a 


156 


H 


72 


d 


101 


130 


m 


159 


1 


73 


n 


102 


131 


Q^Qj 


160 


J 


74 


u 


103 


132 


H 


161 


K 


7S 




104 


f1 133 




162 


L 


76 


X 


105 


f3 134 


1 1 


163 


M 


77 


1 ^^ 


roe 


t5 135 


□ 


164 


N 


78 


H 


107 


f7 136 


u 


165 





79 


U 


108 


f2 137 


m 


166 


P 


80 


N 


109 


f4 138 




167 


Q 


81 


/\ 


110 


f6 139 


y 


16a 


R 


82 


n 


111 


fB 140 


n 


169 


S 


83 


n 


112 


^^^9 ^^^^fl^ 41 


n 


170 


T 
U 


84 
65 


■ 
u 


113 
114 


I1M142 


Lid 
■ 


171 
172 


143 


V 


86 


V 


115 


^K 144 


L 


173 


W 


87 




116 


Q 145 


b_l 


174 


X 


86 


r 


117 


na 146 


Li 


175 


Y 


89 


XI 


116 


M ''' 


fr 


176 


Z 


90 


o 


!19 


H 14^ 


H- 


177 


[ 


91 


+ 


120 


[ ^ 149 


T 


178 


£ 


92 


1 


121 


X 150 


1 


179 


] 


93 


^*J 


122 


O 151 


1 


180 


T 


84 


ffl 


23 


+ 1 152 


1 


iei 


^ 


B5 


B 


24 


153 


3 


1S2 


-1 


S6 


m 1 


25 


4 154 




183 



136 



PRINTS 


CHB$ 


PRIKTS 


CHR« 


PRINTS 


CHTtt 


PRINTS 


CHR¥ 


u 


134 
185 


u 

11 


1S6 
187 


H 


168 
13S 


■" 


190 
191 



CODES 


192-223 


SAME AS 


96-127 


CODES 


224-254 


SAME AS 


160-190 


CODE 


2SS 


SAME AS 


12S 
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APPENDIX G 



SCREEN AND COLOR MEMORY MAPS 



The following charts list whicK memory locations control placfng char- 
acters on the screen, and the locations used to change individual char- 
acter colors, as well as showing character color codes. 

SCREEN MEMORY AAAP 



cam UN 

30 



1024- 

10G4 

1104 

1144 
118* 

1Z24 

net 

13W 
1314 
13S4 

im 

14B4 

1S« 
1544 

15B4 
16Z« 

im 

1704 
1?44 
17S4 
1824 
1S64 
1904 
IW 











































































1I)&3 




































































































































































































































































































































































< 














































































































































































































































































































) 










































































■ 
















































































































































































































1 






























































































































































































































































































j 








1 




































- 








- 














i 






' 












































1 










































































' 
















































































1 










































































1 
























































































































































- 


- 








_ 




„ 






u 


J 






_ 




u 






u 


—I 


u 


u 


u 


_^ 


L 




J 


u 
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13S 



The actual values to POKE Into a color inemary location to chonge a 
charocter's color are: 






BLACK 


1 


WHITE 


7 


RED 


3 


CYAN 


4 


PURPLE 


5 


GREEN 


6 


BLUE 


7 


YELLOW 



8 
9 

10 
] 1 
12 
13 
14 
15 



ORANGE 
BROWM 
Light RED 
GRAY 1 
GRAY 2 
Light GREEN 
Light BLLE 
GRAY 3 



For e?(Onple, to charge the color oi a character located at the upper 
left-hand corner of the screen to red, type: POKE 55296,2. 

COLOR MEMORY MAP 



COLUUn 
20 



SS29E- 

bb33t 

5S37( 

iiW 

55454 

;w« 

5SS36 
S!576 
5iCl£ 
55656 
5S696 

Si776 
5S816 

imi 

5i33G 

5S576 

5«oie 

5(056 
5(09e 
561 3« 
5tl7{ 
SlZlt 
5I25( 



S53J5 



_. itt-X X- 

_J 1- j U — 

I "IIIIIIIIIIIII~i: — _Z_| — .- 1 1 — 

— I j— I ___- — =.^^ — , 

:i:::::::::::::::E:::::::::=::i^ 

1_ 

1— 

)_ 

j_ 



;o e 



t 

56235 
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APPENDIX H 



DERIVING MATHEMATICAL FUNCTIONS 



Functions thot are not intrinsic to Commodore 64 BASIC may be calcu- 
lated as ■follavA/Er 



FUNCTION 


BASIC EQUIWLEMT 


StCAN 1 


ifcc(x)=i/cos{x;i 


COSECANT 


C5C(X) = ]/SIN:X) 


COTANGENT 


COJ{>.) = 1IV>MX) 


INVERSE SINE 


ARCSIN(X)=ATN«/EQR(-X*X4 1)1 


INVERSE COSINE 


ARCCOS:X)=-ATN(X/SQR 




(-X*X +1)) +77/2 


INVERSE SECANT 


ARCSECtX)=A-N(X/5QR(X''X-l)) 


INVERSE COSECANT 


ARCCSC(X)=ArN;x/SQR(X*X- D) 




-(SGNCX)-t*5r/2 


INVERSE COTANGENT 


ARCOT(X)=ATN(X)+7r/2 


HYPERBOLIC SINE 


SI NH(>t)= (EXPiX)- EXP[- X));2 


HYPERBOLIC COSINE 


COSH(X)=(EXP(X)+ EXP{-X))/2 


HYPERBOLIC TANGENT 


TANH(X)= EXP<-X)/(EX=M+EXP 




(-X))*2+l 


HYPERHOIIC SFCANT 


SECH(X)= 2;(EXPtX)+ EXP(- X)) 


HYPERHOI IC COSECANT 


CSCH(X) = ?/(EXP(X)-EXP(-X)) 


HYPERBOLIC COTANGENT 


corH;x)=EXP;-xy(EXP(X) 




-EXP(-X))*2+1 


INVERSE HYPERBOLIC SINE 


ARCSINI-(X;i=lOG(X + SQR(X*X+ D) 


INVERSE HYPERBOLIC COSINE 


ARCCOSH(X)=LOGCX4SQR(X*>:-1)) 


INVERSE HYPERDOLIC TANGENT 


ARCTANH{X)=LOS{<! +XW-X))/2 


INVERSE NYPER60LIC SECANT 


ARCSECH(X)=.OG({SQR 




(-X*X+') + ]/X) 


INVERSE HYPERBOLIC COSECANT 


ARCC5CH(X)=LOQ((SGN(X)*3QR 




(X'-X + I/k) 


INVERSE H-'FERBOIIC COTAN- 


ARCCOTH(X)=LOG(lX+ 1 )i'(x- 1 1)/2 


GEN" 
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APPENDIX 



PINOUTS FOR INPUT/OUTPUT DEVICES 



This appencix is desiyned lo shu^v you what connections may be 
mode to the Commodore 64 , 



1) Game I/O 

2) C«rtildge Slot 

3) Atdia/Video 



Contral Port 1 



Pin 

1 


Type 

JOYAO 


Not* 


I 


JOYAl 




3 


J0YA2 




4 


J0YA3 




5 


POI ftY 




6 


BUTTOh A'LK 




7 


-1-5'/ 


WAX. SOmA 


8 


GNO 




9 


POT AX 





dj 


Seriol I/O (D 


sk/Printpr) 




5} 


Modulator 


o 


utp 


ut 






6j 


Cassette 












7j 


User Port 














r 1 


2 




3 


4 


5 




\ ° 


















\ ° 




O 


o 




° / 




V • 




7 


8 




' J 



Control Port 1 



Pin 

1 

3 
4 

5 
6 

7 

B 
9 



Type 
JOYBO 
JOYBl 

JOYB2 
J0YB3 
POT BV 

BIJTTOM B 
+ iV 

GND 
POT DX 



Note 



MAX. SOmA 
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Cartridge Expansion Slof 



Fin 


Type 


12 
13 


BA 
DMA 


H 


D7 


15 


D6 


16 


D5 


■7 


Di 


B 


D3 


^<} 


D! 


SO 


Dl 


21 


DO 


22 


GMD 



Pin 


Type 


N 


M 


P 


A8 


R 


A7 


S 


A« 


1 


A5 


u 


A4 


V 


A3 


w 


a; 


X 


Al 


T 


AO 


I 


GND 



2i:i Ml lOie i7lMSH 13 13 11 10 9 9 7 « 5 1 3 J 1 



Z f >WVU'SBPNMLKJHFEDCBA 

Audio/Video 



Pin 


Type 


1 


GND 


2 


+ 5V 


3 
4 
5 


+ 5V 
IRQ 

R/W 


6 


Dot Clock 


7 


I/O 1 


S 


GAME 


9 


EXROM 


TO 


I/O 2 


11 


ROMl 



Fin 


Type 


Note 


1 


LUA^INANCE 


2 


GND 




3 


AUDIO OUT 




4 


VIDEO OJT 




3 


AUDIO IN 





Seriql 1/0 




Pin 


Typ« 


1 


SERIAL SRQIN 


2 


GND 


3 


SERIAL ATN IN.'OUT 


4 


SERIAL CLK IN/OUT 


5 


SERIAL DATA IW/OUT 


6 


RESET 



Pin 


Type 


A 


GND 


B 


ROMH 


C 


RESET 


D 


NWil 


E 


S 02 


F 


A15 


h 


A14 


J 


A13 


< 


AI2 


L 


All 


M 


AlO 
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Cassette 



Pin 

A-1 


Type 


GND 


B-2 


+ 5V 


C-3 


CASSEnE MOTOR 


D-i 


CASSETTE RFAD 


E-5 


CASSFTTF WKITE 


F-A 


CASSETTE SENSE 



12 3 4 5 



A B C D E F 



User I/O 



Pin 


Type 


Note 


1 


GND 




2 
3 


+ 5V 
RESET 


MAX. 100 mA 


4 


CNTl 




5 


SPI 




6 


CNT2 




7 


SP2 




g 


PC2 




9 


SER. ATN IN 




10 


? VAC 


WAif lOO mA 


11 


? TOC 


MAX. 100 mA 


12 


SND 





Pin 


Type 


Nale 


A 


GND 






D 


rwGi 






C 


PBO 









PBl 






E 


t>62 






h 


caa 






H 


=BJ 






J 


mi 






K 


l>B6 






L 


=67 






M 


?kl 






N 


GND 







8 9 to 1- 12 



ABCDEFMJKLMN 
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APPENDIX J 



PROGRAMS TO TRY 



We ve included a number of useful programs for you to try vulth your 
Commodore 64. Those prog'oms will prove both entertaining cind 
LsefuL 



100 piri nf'EijottD ji« tiijtt?i"f i e-ld" 

I2t> inpuf't'uant i nstruc t lans" ; E* ; i fasc ( z* » =7Sgoto250 

130 prinfPiry to •guir'5^ the* iiiystfr'y S-letbe"" word'* 

IAD prirt^"5you irtu^-t igw^^s oril^J legal S-l*tt*r'* 

153 pr i nt "uor-ijs, too..." 

Ida prinfyou u i 1 1 hs told th<? namb^r of mstcheB" 

170 prjnt"(oi~ 'jots') cf your gu*ss." 

l&O pr i nt " E'h i n't 5 the trick i^ to van^ slightly^' 

193 print" ffom one- gi4&£S to th* nexts so that" 

203 print" i- you gusss 'batch' sna gst 2 jots" 

210 print" you night try 'botch' or 'chart'" 

225 p*~int" for the n^>i^ gu^^s.*^'* 

25D dsta bsibe' , i pecs ,dbd i f , ««f b<>, p;3gbu 

240 data hpshf , i bud i ,d,iuj rn ,kp(niii£, Ibiibl 

270 data sbkbi ,Mf wfM,n,in jd, boof y, qj of s 

230 data rvf tu^sjuf s ,q5f tt ,pMuf s, fuf ou 

290 data xf bw" , f yupd! ,nvt i z , af est, oj aaz 

300 iJata u i j <Jl f^svo I ,g(npp«,ujhf s, ijb If s 

310 dstd cppu I , msj ph( trvbu , hbvsf , px joh 

320 data u t sf ' , t J h i u <b<jKif t ,h?v^q, bsf ob 

33 data r vtrsu ^ dsf f i:t , c f md t . q^f tt ^ tqbsl 

343 data Bt<«bs,sv£bM ,tnf igM,gsp»!o, 4'S jgu 

liOa n=50 

413 dim nt(n) ,z(5) ,y<5> 

^20 for j=l torn re3dn*< j ) inextj 

i,30 t=tl 

440 t-t^lOOOri ft>-lth*r>goto440 

ISO ==rfid<-t> 

500 g=0:n* = r>t(nda)*iTH.) 

510 print "&i haw* a five letter word i " : i f i->0qotD5i0 

320 pi-irt "gu^ss (with legal words>" 

530 prli^t "and i'll tS'W you I'low wary" 

540 prirt "^jot&'j or r^atching l#tters^" 

550 print "gou tiav*..,," 

5i0 g-g+li input "your uord'iz* 

S70 if t ff n ( 7* i < n''nt h^npr i nt " y nij fi^ij<%t p^uw^ir a 

5-lette>r word ! " : goto560 
5S0 u=O:h=O;m=0 
590 forj=lto5 

600 2 = ssc (ai i dt(E4, j , 1) ) !y = 3 5c (m id*(fi*, j , 1 t )-l; i f y=i4th«'hy = 90 
610 i fz';65orz>yotlienpr i nt"th3t' s not a uord ! ": gotca^O 
6S0 i f3-65ur-i='6?tiri:-73i.r£J7yuri:-S5or£^S?thenv^v«-l 
i30 i f2*>>jihe-nn"»i-i-l 
440 T( j ) = 7 : ijf j )=y:n^!jtj 
650 iffn = 5qotGS00 
660 i f v = 0orv = 5tS*nfir i nt " cofii"^ on, .what i^'Lind of 

a kford i5 thst?" ! CjotoSSO 
6 70 for j = lto5:y = y ( j ) 

6eo for K = l+,gS: i fy==(k ) thenli--hi-l : ^< k)=0 :qoto7';0 
490 rt^>i-t ^. 
700 nfiixt j 

710 prirfanDacuDHOnnfirnEinEiiiiac" jH;" jdts" 
720 ifo<30aoto56O 

730 pr i rt" i ' d -better telT you., uord U3^ '"; 

740 forj = lto5;pr intchrtiytj ) i j sne^tj 

7iO pi-i rt" ' " : gotoSIO 

aOO pr-irt'you got it in only " ;(j ;" guesses . " 

£10 i npii t "Ssnot-ie-r word"i^* 

820 i" = l : i -f sac ( ^t ) ■i:>78goto500 
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i rem **s sfauisnce' 

3 rspo *** front pet ut*r 9rDUf' 
^ refti 44 SS 5P+'twgr* exchange 

5 r#(o **« pD biDM 3>1 

6 re« *** mnntgoirie'rgv i ■. Ic , pa ia?36 

7 rem 

50 din st(26> 

lOO 2t="3tJCd6'fghi ji<lii»fiODqr&tuvwJ!U2" 

110 7lt = "123'ibi/S9C1234i.o7aV0l:i3.Ai6" 

200 pr * n t " SPE'^nter length of stprinQ "to t'e se'quenc t- dE^" 

220 i rtpui "wsK ifrtum Itj-i^t^tJ'i is *^6 "^s5^ 

2.^0 if ^XCl or m:X>26 ths-n ?00 

300 for i-1 to s 

310 sl( i )-f(ij d*(z*, 1,1) 

320 n*;:t i 

^00 r (fW f an JuBi i ^f string 

ti'JO tor i-1 to = 

•430 ks i nt (r-id( 1>*5-»1 ) 

440 tt=3t( i ) 

450 3i ( i )=a*(k) 

A60 at (k )=tt 

470 n*>:i i 

4ao oosub 9t)0 

5V5 t=0 

600 reM r^-vs-rE-E- sijtE'trincr 

60S t=t+l 

610 input "'iow mianu to re^e-rst' ";rX 

&20 i f rZ = goto 900 

630 if rX>0 snd r/!'; = E goto 650 

i'lO print "nust be t^tu^sn 1 and "fSi aoto 410 

650 r= ir,t(rX/2) 

iiO for i=l to r 

670 tt=3*( i > 

680 3< ( i )=s*(rX- i+1) 

6^0 3t(r/:-t+l)=t$ 

700 n^xT, i 

7t.O qoswCi ViO 

a<JO c-l : for i -2 tc 3 

810 if 3«[ i >>3«< i-1) qoto mo 

fl20 c=0 

£20 next, i 

8^0 if c=0 jolo iOO 

850 Print "Eiyou did it in "st;" tries' 

"?tO r*(a che:h for atiother gasie 

910 input "Pw^nt to pl^y ^qsin " i y* 

9S0 jf Iwftt (y*, 1 )="ij" Of yt^"ok" or igt="l" goto 200 

9a0 end 

950 pr int 

9i0 print lef t*< si * , E J 

970 for i=t to s: print attiJiinoit i 

?eo pr int "S" 

990 return 

This prugrm courtes); of Gere Deals 
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90 REM F'lHHO [■::EVE:OFlRD ^ 

nm? F-RiMT''3 a n a i w lu ?ji i M hi i ^j el " 

liij PPIHT" a !.l a I i!l !«l d i l"J Si I 111 iu ■' 

120 PRINT" a M w I a a m j m lui i u i«j " 

l:3ti RRIHT" j3 I ( I I I i I f 1 I I I ■■ 

14y PRIHT" Ji:: |W IE IR IT IV lU il iO IP IS I* IT" 

ir:Hi PRII-)T"a'SPfiC"' FOR SOLO OR rOLVTI lOHIC 

153 PRIHT":a'Fl .,r3.r5,F7' OCTflyE SELECTIiJW" 

1713 P-PrMT"i]'F2 .F4.FiS,Fe' WfiV-'EFORMW" 

130 PRIHT"HfiHe ON. SETTING UP FREQUENCV TABLE..." 

19^ S=13:*4e?S-i-ltj24 jDInFsISS:' :D t MK'C25^> 

QOa FOR I^eTiJ-J^S :F-0KE3+I .J'H: NEXT 

2ie f- l = r'U4ti ;f-UKl. = l \ ijit :Ft 27-1 > =F1*5. S+:I-i? ; Fl =Fl,--'2:-|- '.: J .■■'!.£:■' :ME;-,T 

i2i? KS=''©£HSERri-6V7U15O0Pi2-* CT" 

230 FORi=iT0LEH';i-:*> sK';r;;c<tiiD*<: K*.ir'>:>-i :hekt 

1413 FRIHT":^ 

2=;f^ flT=0!rP=0!SU=15jRE=.?!S'-'^SLi*16+RE!flV=RT*l»+DE : 

WV=ie :l-i==0 :t'1- 1 :0r:=4 :HE!=25b iZ-e 

SSO FOR I»eiTi:X: ; Pi:iKE3+5+ 1 *7 . AT:-* 1 b+:iE s POKES+iS + 1*7' ^SIj* 1 6+R'E 

i7S pi>::ES+£ + I-*?.,4eCi3FlMCi355:PGKES+;3+I*7^4Oy0/25c::HIE:':T 

288 P0KES+£4^ !5 :REM+lS+e4 ;POKeS+33r 7 

1300 GETftf ;IFFtS = " "THEH3S0 

1 e FR"r<K<PSi: ■; Fi* > ; ::• r'M sT-V-*T' iCF:-S-i-T+4 ; IFFR=2:T-iei-!Eye 

■J2e POKES+^+T,Z:REM FINISH DEC-'^JS 

325 P0KE9+5-1.T .ZsREN FIHISH fiTT/REL 

33i3 POKECR..G ;POKECR.,0!ffEN FI;^ OF- 

340 FOKES+T.FP-HBi»iIHT'::FR/HE> jREM ;?ET LO 

3SiS P0KE9+l+T,FR/HE;sREM SET HI 

3i;0 P0KES+*-+T,,SV!REl-1 SET dEC/SUS 

365 P0KES+5-fT,HVsRE(1 SET HTT/'REU 

37Q PpKECR..W'v'H-l iF0RI~iTO.'rO*RT5NEXT 

375 POKECR.,^V:REM PULSE 

3S13 EFP = lTHENV = 7-i-l : IrV=3THENV=9 

4)30 G0TCi3SG< 

500 IFnt="iS"THEHt-1=l :0C=4 iGOTOSeO 

5iei IFfl*="H"THEHM==2:Oi:--3!eQT03eei 

l!£? [FFi*='ia"THeNF-f=4:0D=i: i^JOTO-JSO 

5313 IFR«="Bi"THENM=g:OC=l :GOT0Oer3 

540 [Ffl*-"HI"THEHH-0=i.iy..lii. -C0TO2OB 

SiSm IF=I*="1!"THEHW = X !NV-32;IjOTO30^3 

5t?tS IFR:^="ai"THENW=25NVM;4 sCOTOSOS 

S7i3 IFq-t="1l"THEHN=3:UV=12SiG0TCi39a 

530 IFns=" ■'THEMP=l-P:iJi:iTG"i08 

3i?ei IF^*n!"a"THEM£e© 

SOQ PRIMT"HIT R KEV" 

SIO OETM*!:[FHl = ""THENSHii!UlfiIT FOR ^ KEV 

.■?2e PRIHTfi* :RETIJRH 

NOTES; 

Line IPO uses (SHIFT CLRiHOME), Line 530 uses (17) 

(CTRL 9WCTRL D.iSHIFT B). Line 5*0 uses (12) 

Line IbO us«s (CRSfl DOWN) Line 550 uses (14) 

Line £40 uses (CFSP UP) Line 560 uses (IS) 

Line 500 «9fiS (f1) Line £70 uses (IS) 

Linp S-tO uses ifS) Line S90 uses (SHIFT CLRMOMEJ 

Una 520 uses IfSj 
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APPENDIX K 



CONVERTING STANDARD 
BASIC PROGRAMS TO 
COMMODORE 64 BASIC 



If- you have programs written in o BASIC *nther tlicin Commodore 
BASIC, some minor adjuslrnents may be nc<;e3Sory before running them 
on the Cammodore-64. \flteVe Included some hints to make the coriver- 
sioT easier. 



String Dimensions 

Delete nil statements that are used to declare the length o-f strirgs. A 
statement such oi DIW. A$(l,J)j which dimensions q striig array for J 
elements of length I, should be converted to the Commodore BASIC 
statement DIM A$(J). 

Some BASICS use a comma or ampersand for string concatenation. 
Each of these must be changed to a plus sign, v/hich is the Commodore 
BASIC opercitor for string concatenation. 

In Com'nodore-64 BASIC, the MID$, t?IGHT$, and LEFT$ lurctions are 
used to toke substrings of strings. Forms such as Aid) to access the Ith 
charocter in AS, or A$(I,J) to take a substring of A$. from position I to J, 
must b^ i:hancj$d a5 fellow*; 

Other BASIC Cotnmodwe 64 BASIC 

A$(l) = X$ A$ = LEFT$(A3,I-1) + X$+M{D$(A$,I + 1) 

A$(I,J) = X$ A$ = LEFT$(A$,I-1) + X$ + M1D$(A$,J+1) 



Multiple Assignments 

Td set B ond C equal to zero, some BASIC5 allow statsments of the 
form: 

10 LET B=C=j^ 



r4S 



Commodore 64 BASIC would inlerpret the second equal sign as a 
logicol operator and let R = —1 li C = 0. Instead, convert this state- 
ment to; 

]0 C=0 : B = 

Multiple Statem«f)'t3 

SoiTie BASICS use a backslash (\ ) to separate multiple statemen's on 
a line, V/ith Commodore 64 BASIC, separate ail statements by o colon 
(0- 
MAT Functions 

Programs using the MAT functions avoilabie on some BASICs must be 
rewritten using FOR. , .NEXT loops to execute properly. 
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APPENDIX L 



ERROR MESSAGES 



This appendix contafns a complete list of the error messages gener- 
ated by the Commodore-64, with a description ot causes. 

BAD DATA String data was received fro-n an open file, but the pro- 
gram was expecting numeric data. 

BAD SUBSCRIPT The program was trying to reference cin ©i^rrent of 
an array whose number is outside of the range specified in liie DIM 
statement. 

CANT CONTINUE The CONT command will not work, either because 
the prograrr v/as never RUN, thsre has be«n an error, or o line hos 
been ediled. 

DEVICE NOT PRESENT The required I/O device was not available far 
an OPEN, CLOSE, CMD, PR1NT#, INPUT*, or GET*. 
DIVISION BY ZERO Diuision by zero is a mathemotical oddity and not 
allowed. 

EXTRA lONORED Too mony items of data were typsd in response ig 
an INPUT statement. Only the first few items were accepted. 
FILE NOT FOUND If you wers looking for a file on tape, and END-OF- 
TAPE morker was found. If you were looking on disk, no file Mrh that 
name exists. 

FILE NOT OPEN The file specified in a CLOSE, CAflU, PRINT#, [NPUT#, 
or GET#, rnust first be OPENed. 

FILE OPEN An attempt wos made tc open o file using the number of 
un ulreudy open Rltr. 

FORMULA TOO COMPLEX The string expression being evaluated 
should be split into at least r^fo parts for the system to work with, or a 
formula has too many porentheses. 

ILLEGAL DIRECT The IMPUT statement can only be used within a pro- 
gram, and not In direct mode. 

ILLEGAL QLJANFITY A number used as the argument of a function or 
statement is out of the allowable range. 
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LOAD There \%. a problem with the program ou tope, 
NEXT WITHOUT FOR This is caused by either incorrectly nesting loops 
or having a variable rame in o NEXT statement that doesn't correspond 
with one in a FOR slulement. 

NOT INPUT FILE An Qltempt was made to INPUT or GET cata fronn a 
file which was specified to be for output only. 

NOT OUTPUT FILE An attempt was made to PRINT data to a file which 
was soeclfled as input only. 

OUT OF DATA A ?EAD statement was executed but there is no dota 
left urREAD in a DATA state meni. 

OUT OF MEMORY There is no n-ior& RAM ovoiloble for program or 
variables. This may calso uct.ur when too many TOR loops hove been 
nested, or when there are too mary GOSUBs in effect. 
OVERFLOW The result of a computation is lorger tfian the largest 
number allowed, which is I .70U1 aS4E + 38. 

REDIM'D ARRAY An array may only be Dimensioned once. If cm array 
variable is u$ed before that array is DIM'd, an autonnatic DIM operation 
is performed on that array setting the number of elemen-s to ten, aid 
ariy subsequant DIMs will ccuse this error. 

REDO FROM START Character data was typed in during on INPUT 
statement when numeric data was expected. Just re-type the entry so 
that it is csrrect, and the program will continue by itself. 
RETURN WITHOUT GOSUB A RETURN stotement wos encountered, 
and no GOSUB command has been issued. 

STRING TOO LONG A string con coniuin up to 255 characters. 
?SYNTAX ERROR A statement is unrecognizable by the Commodore 
6d. A missing or extra parenthesis, misspelled keywords, etc 
TYPE MISMATCH Thi5 error occurs when o number is used in place of a 
string, or vice-ve'sa. 

UNDEF'D FUNCTION A user defined function was referenced, but it 
has never been defined using the DEF FN statement, 
UNDEF'D STATEMENT An attempt was made to GOTO or GOSUB or 
RUN a line number thul doesti't exist. 

VERIFY The program on tape or disk does not match tiie ptogram cur- 
rently in memory. 
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APPENDIX M 



MUSIC NOTE VALUES 



This aopendix contoins a complete fist of Note#, actual note, end the 
values to be POKEd into ihe Hi FREQ cind -OW FREQ registers ©4 the 
sound cliip to produce tfie indicated note. 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECiMAL 


HI 


LOW 





C-0 


268 




12 


1 


C#-0 


284 




28 


2 


D-0 


301 




45 


3 


D#-0 


318 




62 


^ 


E-0 


337 




31 


5 


F-0 


358 




102 


6 


F#-0 


379 




123 


7 


G-0 


401 




U5 


3 


G#-0 


425 




^h9 


9 


A-0 


451 




195 


10 


A#-0 


477 




221 


n 


B-0 


506 




250 


16 


C-1 


536 


2 


24 


17 


C#-l 


568 


2 


56 


16 


D-' 


602 


2 


9*0 


19 


D#-l 


637 


2 


125 


20 


E-1 


675 


2 


163 


21 


F-1 


76 


2 


204 


22 


F#-l 


758 


2 


246 


23 


G-l 


803 


3 


35 


24 


G#-l 


851 


3 


83 


25 


A-1 


902 


3 


134 


26 


A#-l 


955 


3 


167 


27 


B-1 


]012 


3 


244 


32 


C-2 


1072 


4 


48 



152 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIAAAL 


HI 


LOW 


33 


C#-2 


1136 


4 


112 


34 


D-2 


1204 


4 


180 


35 


D#-2 


1275 


4 


251 


36 


E-2 


135] 


5 


71 


37 


F-2 


1432 


5 


152 


38 


F#-2 


1517 


5 


237 


39 


G-2 


U07 


6 


71 


40 


G#-2 


1703 


6 


167 


41 


A-2 


1804 


7 


12 


42 


A#-2 


191] 


7 


119 


43 


B-7 


2025 


7 


233 


46 


C-3 


2145 


8 


97 


49 


C#-3 


22/3 


3 


225 


50 


D-3 


2403 


9 


104 


51 


D#-3 


255] 


9 


247 


52 


E 3 


2703 


10 


143 


53 


F-3 


2864 


] 1 


4B 


54 


F#-3 


3034 


11 


21B 


55 


G-3 


3215 


]2 


]43 


56 


G#-3 


3406 


13 


7S 


57 


A-3 


3603 


14 


24 


58 


A#-3 


3823 


14 


239 


59 


B-3 


4050 


15 


210 


64 


C-4 


429] 


16 


195 


65 


C#-4 


4547 


]7 


195 


66 


D^4 


4817 


18 


209 


67 


D#-4 


5103 


19 


239 


68 


E-4 


5407 


21 


31 


69 


F-4 


5723 


22 


96 


70 


F#-4 


6069 


23 


lei 


71 


G-4 


6430 


25 


30 


72 


G#-4 


6812 


26 


156 


73 


A 4 


7217 


28 


49 


74 


A#-4 


7647 


29 


223 


75 


B-4 


810) 


31 


165 


80 


C-5 


8583 


33 


135 


SI 


C#-5 


90W 


35 


134 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


52 


C-0 


9634 


37 


162 


83 


C#^0 


10207 


39 


223 


84 


D-0 


10814 


42 


62 


85 


F-5 


11457 


44 


193 


&i 


F#-5 


12139 


47 


107 


67 


G-5 


12360 


50 


60 


83 


G#-5 


13625 


53 


57 


89 


A-5 


14435 


56 


99 


90 


A#-5 


15294 


59 


190 


91 


B-5 


16203 


63 


75 


96 


C-6 


1/167 


67 


15 


97 


C#-6 


18188 


71 


12 


9a 


D-6 


19269 


75 


69 


99 


D#-6 


20415 


79 


191 


100 


E-6 


21629 


84 


125 


101 


F-6 


22915 


89 


131 


102 


F#-6 


24278 


94 


214 


103 


G-*. 


25721 


100 


121 


104 


G#-6 


27251 


106 


115 


105 


A- 6 


28871 


112 


199 


106 


A#-6 


30588 


119 


124 


107 


B-6 


32407 


126 


151 


112 


C-7 


34334 


134 


30 


113 


C#-7 


36376 


142 


24 


114 


D-7 


38539 


150 


139 


115 


D#-7 


40830 


159 


126 


116 


E-7 


43258 


163 


250 


117 


F-7 


45830 


179 


6 


118 


F#-/ 


48556 


189 


172 


119 


G-7 


51443 


200 


243 


120 


G#-7 


54502 


212 


230 


121 


A- 7 


57743 


225 


143 


122 


A#-7 


61176 


238 


248 


123 


B-7 


64314 


253 


46 
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FILTER SEHINCS 



Localion 


Contents 


542?3 


Low curoff frequency (0-7) 


54294 


High cutoff frequency (C— 255) 


54295 


Resonance (bits 4—7) 




Fiiter voice 3 (bit 2) 




Filter voice 2 (bit 1) 




Filter voice 1 (bit 0) 


54296 


High pass (bit 6) 




Bandpass (bit 5) 




Low pass (bit 4) 




Volume (bits 0-3) 
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APPEt4DIX N 



BIBLIOGRAPHY 



Addison-Wesley 

Conrvpute 

Cowbay Computing 



"BASIC and the Personal Compjter", Dwyer 
and Critchfield 

"Compute's First Book of PET/CBM" 

"Feed Me, I'm Your PET Computer", Carol Al- 
exander 

"Looking Good with Yogr PET", Carol Alexan- 
der 

"Teacher's PET — Plans, Quizzes, ond An- 
swers" 

"Getting Acquainted With Yotr VIC 20", 
T. HartnotI 

"BASIC Basic-English Dictionary for the PET", 

Lorry Noonon 

"PET BASIC", Tom Rugg and Phil Feldman 



Faulk Baker Associates "MOS Programming Mental", MOS Technol- 
ogy 



Creative Computing 



Dilithiuim Press 



Hoyden Book Co. 



"BASIC From the Ground Up", David E. Simon 

"I Speak BASIC to My PET", Aubrey Jones, Jr. 

"Library of PET Subroutines", Nick Hampshire 

"PET Graphics", Nick Hampshire 

"BASIC Conversions Handbook, Apple, TRS- 
80, and PET", David A. Brain, Phillip R. 
Oviott, Paul J. Paquin, and Chcndler P. Stone 



t5« 



Howard W. Sami 



Littia, Brown & Co. 



McGraw-Hill 



O^borne/McGrnwi-Hill 



P. C. Publications 



"The Howard W. Sams Crash Course in Mi- 
cracomputers", Louis E, Frenzel, Jr. 

"Mostly BASIC: Applications for Your PET", 
Howard Berenbon 

"PET inrerfacing", James M Downey and Ste- 
ven M. Rogers 

"VIC 20 Programmer's Reference Guide", A. 
Finkel, P, Higginbottom, N. Harrii, and M, 
Torritiyk 

"Computer Games for Businesses, Schools, 
and Homes", J. Victor Nagigian, and William 
S. Hodges 

"The Computer Tutor: Learning Activities for 
Homes and Schools", Gary W. Orwig, Urlver- 
tity of Central Florida, and William S. Hodges 

"Hands-On BASIC With a PET", Herbert D. 
I'eckman 

"Home and Office Use of VisICalc", D. 
Costlewitz, and L. Chlsauki 

"PET/CBAA Pftrsonal Computer Guide", Carroll 
S. Donahue 

"PET Fun and Games", R. Jeffries and G. 
Fisher 

"PET and the IEEE', A. Osborne onA C. 
DongIii,e 

"Some Common BASIC Programs, for the PET", 
L. Poole, M, Borchers, and C. Donahue 

"Osbcfrne CP/M User Guide", Tilom Hogan 

"CBM Prcfesslonal Computer Guide" 

"The PET Personcil Guide" 

"The 8086 Book", Russell Rector and George 
AUxy 

"Beginning Self-TencKitig Cfinnputer Lessons" 
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Prentice-Hall "The PET Personal Computer for Beginners", 

S. Dunn and V, Morgon 

Reston Publishing Co. "PET and the IEEE 488 Bus (GPlBr, Eugene 
Fisher and C, W. Jensen 

"PET BASIC — Training Your PET Computer", 
Ramon Zcimora, Wm F. Carrie, and B. 
Allbrecht 

"PET Games and Recreation", M. Ogelsby, L. 
Lindsey, ar»d D. Kunkin 

"PET BASIC, Richard Huskell 

"VIC Games and Racreation" 

Tel mas Coursewort "BASIC and the Personal Computer", T. A. 
Ratings Dwycr, and AA, CriTchfield 

Total Information Ser- "Understanding Your PET/CBM, Vol. 1, BASIC 
vke« Programming" 

"Understanding Your VIC", David Schultz 

Commodore Mogazines provide you with the most up-to-date infor- 
motion for your Commodore 64. Two of the most popular publicotions 
thot you should seriously consider subscribing to are: 

COMMODORE — Tfie A/lrcrcjtompoter Alagazine is published bi-monthly 
and is available by subscription (t 15.00 per year, U.S., and $25.00 per 
year, worldwide}. 

POWER/PLAf — The Home Computer Magazine is published quarterly 
and is availoble by subscription tllO.OO per year, U.S., and $15.00 per 
year worldwide). 
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APPENDIX 



SPRITE REGISTER MAP 



Dec Hex 


DB7 


Dfl6 


Db5 


DB4 


DB3 


DB2 


DBl 


DBO 






1 1 

2 2 

3 3 

4 4 


50X7 














soxu 


SF'Klib JK 
Conn parent 


S0Y7 














S0Y3 SPRITE Y 
Component 


51X7 












SlXO SPRITE 1 X 


51 Y7 






i 






S1Y0 SPRITE 1 V 


S2X7 












S2X0 SPRITE 2 X 


3 5 


32 V7 












EIYO SPRITE 2 V 


6 6 


S3X7 






1 






S3X0 SPRITE 3 X 


7 7 
B A 
9 9 

10 A 

11 B 

12 C 

13 D 

14 E 

15 F 

16 10 

17 11 
13 12 

19 13 

20 14 


|53Y7 












;3Y0 


SPRITE 3 V 


S4X7 












S4X0 


SPRITE 4 X 


S4Y? 












S4YCJ 


SPRCe a V 


S5X7 










$5X0 


SFR1''E J X 


S5Y7 














55 YO 


SPRITE 5 Y 


S6X7 














S6X0 


SPPrE s X 


S6V7 














S6V0 


SPRITE 6 Y 


S7X7 














S7X0 


SPRITE 7 X 
Corriponcnl 


S7y7 














S7Y0 


SPRTE 7 V 
Component 


37X8 


56X& 


35xa 


34XS 


S3Xa 


S2XB 


S1X8 


S0X8 


MSB of X 
COORD. 


DCS 


ECAA 


BMM 


SLNK 


RSEL 


YSCL2 


rscLi 


YSCLO 


y SCROLL 
MODE 


RC7 


RC6 


RCS 


KC4 


RC3 


RC2 


RCl 


RCO 


RASTER 
LIGHT PEN X 


\PX7 














IPXO 


LPY7 














IPYO 


LIGHT PEN Y 



159 



Registsr 


# 
Hex 


t5B7 


DBd 


DBS 


DB4 


DB3 


DB2 


D&1 


DBO 




21 


15 


Sf7 














SEO 


SPRITE 
ENABLE 


:2 

23 


1« 

17 


















(Om;ofF) 


N.C. 
5EXY7 


N.C. 


RST 


MCM 


CSEL 


XSCL2 


XSCLl 


KSCLO 


>: SCROLL 
MODE 












iEXYO 


SPRITE 


24 


16 


















EXPAND V 


VS13 


VS12 


VSll 


VSIO 


CB13 


CB12 


CB11 


M.C, 


SCREEN 






















Chaiatfer 


!S 


19 


















Aflemory 


IRQ 


N.C. 


N.C. 


N.C. 


LPIRQ 


ISSC 


ISBC 


RIRQ 


Iriterup- 


56 


1A 


















Requesl's 


M.C, 


N.C. 


N.C. 


N.C. 


,WLPI 


MISSC 


MISBC 


WfiRQ 


I nt^ ru p- 






















Rcquesf 


27 


IE 


















MASKS 


&SP7 














BSPO 


Bockg round- 






















Sprite 


20 


IC 


















PRIOR ry 


SCM7 














SCArtO 


AAULTICOLOR 
















' 




SPRITE 


29 


ID 
















SELECT 


SEXX7 












SEXXO 


SPRITE 


20 


le 
















EXPAND X 


&SC7 














S5tt) 


Sprite- Sprite 


3] 


IF 


















CJOLUSIOM 


SBC7 














SBCO 


Sprite- 






















Bflrkorol^r^H 






















COIIISION 



l«0 









COLOR CODES 


DEC 


HEX 


COLOR 


32 
33 
34 

35 
3i 
37 

3^ 
39 

4Q 
41 
42 
43 
44 
45 
46 


20 
21 
22 
23 

24 

25 

26 

27 
28 
2?> 
2A 
2B 
2C 
ZD 

2E 


C 

1 

2 
3 
4 
5 

* 

7 


BLACIC 

1 WHITE 

2 RED 

3 CYAN 

4 Pl-RPLE 

5 GBEffJ 

b BLUE 
7 YELLOW 


EXT 1 








EXTERIOR COL 


BKGDO 










BKGD1 










BKGDi 










BKGD3 










SMC 








SPRITE 
MJLTICOLORO 


SMC 1 








1 


SOCOL 








SPRITE COLOR 


10 

n 

12 
13 

14 
IS 


8 ORANGE 

9 BROWN 

A LT RED 
B COAY 1 
C GRAY 2 
D LT GREEN 
E LT BLUE 
F GRAY 3 


51 COL 








1 


S9COL 








2 


S3COL 








3 


S4COL 








4 


S5COL 








i 


S6COL 








4 


S7COL 








7 













LEGEND^ 

ONLY COLORS 0-7 MAY BE USED IN MULTICOLOR CHARACTER MODE 
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APPENDIX P 



COMMODORE 64 SOUND CONTROL 
SETTINGS 



This handy table gives you the key numbers you need to use in your 
sound programs^ according to whtch of the Commodore 64's 3 voices 
yo'j want to use. To set or odjua- a aound control in your BASIC pro- 
gram, just POKE the number from the second column, foHgwed by a 
comma {,) and a number from the chart . . . like this: POKE 54276,17 
(Selects c Triangle Vi/aveform for VOICE 1). 

Remember that you must set the VOLUME before you car. generate 
sound. POKE54296 followed by a nunnber from to 1 5 sets the volume 
for all 'd voices. 

It takes 2 separote POKEs to generate eoch mujical note ... for 
example POKE.54273,34;POKE54372,75 designates low C ir tlie sample 
scale below. 

Also . . . you aren't ilrrilted to the numbers shown in the tables. If 34 
doesn't sound "right" for a low C, try 35. To provide o higher SUSTAIN 
or ATTACK 'ate than those shown, odd tiwo or more SUSTAIN numbers 
together. (Examples: POKE54277,96 combines two attock rates (32 and 
64) for a combined higher otrack rats . , . but . . . POKE54277,20 
provides a low attack rate (16) and a medium decay rote (4). 



162 



1 SETriNG VOLUME — SAME FOR ALL 3 VOICES | 


I VOIUAU CONTROL POKEU^^i 


S.ttir.s* r-ons* ff»m (sfO to 15 (louj.i-) | 


^^^ijjj^: 


TO COMTROL 
THIS SEHING: 


POKE THIS 
M UMBER: 




fUL 
H> 


LOW 
15 . 


C BT ONt Of THESE Nl;MBe«S 

. . or r . r to 255 dtp^nding on r(aog«) 






TO PIA> A N6TE 


C 


C# 


D 


[>« 


E 


F 


Ft* G a# 


A 


4# 


B 


C 


C# 


HIGH FtEqUEMC/ 


i*7T3 34 


M 


38 


40 


43 


45 


48 51 S4 


37 


i1 


44 


&3 


7S 


tow PRiaUENC^ 


J42T! ?5 


95 


124 


2(W 


52 


i«e 


1S7 !>7 


11) 


172 


26 


13a 


149 


16« 


WAVEFORM 


POKE 


THANGLf 


SAVSfTOOTH 


PULSE 


NOISE 1 




i42?6 


T7 


3J 


45 


» 1 


PULSE BATE (^lu 


lAo-fform) 




1 


HI PULSe 
LO PULSE 


54275 
54274 


A ^tilv 
A ^ala 


^ of r 
* 0* » 


1 13 (for 

1 ^55 (f< 


Pulie w 
>r Pulse 


raveform 


cnlyl 

m an\y} 






ATTACK' DBS AV 


POKE 


ATK4 


ATK3 


ATK5 


ATKI 


DEC4 


QE<:3 


DECS 


0EC1 


5417r 


123 


44 


32 


16 


8 


4 


2 


1 






MIMiiliiilBiliiliillilliM 


■,'SRH?T[Iffl?fr-: ■ 


TO PUT A NOTE 


c 


c# 


D 


D# 


E 


F 

45 
19S 


F# 

4S 
127 


G 

51 


5i 

111 


A 


A# 


e 


c 


C# 


HIGH FKEOUENCy 
LOW FREOJEWCY 


542S0 at 
!4i7P 7S 




3B 

12* 


40 
100 


43 


57 
173 


41 
156 


64 

IBS 


T« 


7i 

16? 


WAVEFORM 


POKE 




TWAh 


GLE 


SAW! 


rooi 


rn F 


ULSE 


M0I5E 






a42ej 


17 


33 65 IS* 1 


PULSE RATE 

Ml PULSE 
LO FUUE 


34291 


A vdI^jb dT In 15 (f«r Pulxs viavtioTm ^My] 
A voIjb of ic 2^5 (for Pula* w4T«form only) 




ATTJlCK/DECiV 


POKE 


ATK4| 


ATKJ 


ATIC2 


ATKl 


DEC4 


DEC 3 


D£C2 


DEC1 


51284 


r 


IS 
SB 

JS4 

m 


M 


33 


16 


8 


4 


2 


1 


SJSIAIH/RELEASE 


POKE 


S 

1 


SUS3 
44 


SUS2 

3: 


SUS1 

16 


REU 
8 


RE13 

4 


REL2 

3 


RELl 
1 
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■Hn^^^^^ 


TO PUY K NOTE 


C 


c# 


D 


D# 


E 


F 


F# 


G 


0# 


A 


A# 


B 


c 


C# 


MISM FKeaUENCY 


341ft; 3i 


36 


3B 


40 


43 


43 


4B 


31 


S-i 


57 


61 


t4 


6B 


72 


LOW FREOUENCT 


S*lit 75 


es 


12« 


ZOO 


iZ 


I9S 


iir 


»7 




111 


17! 


26 


lea 


149 


169 


WAVEFORM 


fOU 


TR ANGLE 


SAWTOOTH 




FULSE 




NOISE 




S4»t> 


17 


ia 


^3 


lit 1 


PUISE RATE 


j-iaap 


A val 
A .cl 






■ 


HI PUISE 

LO PULSE 


a» of < 




[-f^t- Pull? wov^f^rm ^i^Ey} 




AHACK/DECAY 


POKE 


ATIM 


ATK3 


ATKJ 


ATKl DiC* 


DtQi 


DEC2 


DEC! 


}4If1 


12S 


64 


32 


16 g 


4 


2 


1 


SUSTAIN/AELEASE 




SUSl 
118 


SUS3 

«4 


&US2 


SUS1 nEL4 

i« a 


DELS 

4 


del: 
s 


REL1 
1 



TRY THESE SETTINGS TO SIMULATE DIFFERENT INSTRUMENTS 


Instrument 


"Waveform 


Attack/ Decay 


Sustdin/Raleate 


Pul» Rcie 


Pionp 


Pulse 


9 





Hi-0, Lo-255 


Flute 


Trfonge 


9S 





Net applicable 


Hcrpsichord 


Sawtooth 


? 





Not oppllcable 


Xylophone 


Triongle 


9 





Not cppliccibb 


Orjcin 


Triongle 





240 


Not cpplicable 


rdliopft 


Triongie 


Q 


240 


Not applfcable 


Ac.c.ard'mn 


TriGhgie 


102 





Not cpplicable 


Tnimpftt 


Snwtnrtth 


96 





Nat cpplicable 



MEANtWGS OF SOUND TEftMS 

AD5R — Afia-rk/bflcay/Iucfa I n/R*U«*a 

A-»te*k — «<i» (vvAd ')•*• *o- p*fllt vflltm» 

Dveny — rate B«wnd falli fra'm peak v»lvFn« t? Sv'-'l^ii (■■'•I 

Suafain- preleng nd-Tfl ar certain veliiinD 

Rer*(9ie — rate at whkh vfllum* foUf* Irgm 9v;tDir IbukI 

Wcaferm — "*Snpt" ijt sound wnfe 

Pulw — tone qiallti^ of Tulsti "Yanrfarni 

NOTE; Aftack/'Decay and Sustufn/Rele'^iie istlir yi slioutj uFwuy> be POKEd '\ia yuur pru-grcm-i 
BEFORE th* Waveform i& POKEd. 
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INDEX 



Abbreviations, BASIC commonds, }3D, 

131 
Accessories, viii, 106-1 OB 
Addition, 23, 2<5-27, 113 
AND op^ratQi, 114 
Anlmyriur), 43-44, 65-66, 69-75, 132, 

138-139 
Arltkmefic, Operators, 23, 26-27, 

113-114 
Arithmetic, Formjlas, 23, 26-27, 113, 

120, 140 
Arrays, 95-103 
ASC function, 128, 155-137 
ASCII charocter codes, 135-137 

B 

BASIC 

dbbreviatisris, 130-131 

C^mmandt, 11J-117 

nom^ric- func+iont, 125-127 

opeiators, 113-114 

olher functions, 129 

statements, 317-125 

string -funetions, 123 

variables, 112-113 
Bibliography, 154- T5B 
Binary arithmetic, 75-77 
Bit, 75-76 
BL^&ine^s aids, 108 
Bvt«, 76 



Calculations, 22-29 

Cassette tape recorder (audio), ^fiii, 3, 

18-20, 21 
Cassette tape recorder (i/idec), 7 
Cassette, port 3 
CHR$ function, 36-37, 46-47, 53, 

53-60, 113, lis, 135-137, 143 
ClR sfotemeiit, 117 
CLIVHOME key, 15 
Clock, 113 

CLOSE statement, 117 
Color 

odjuitinent, 1 1-12 

CURI codes, SS 

keys, 56-57 

memory map, 64, 139 

PEEKS and POKES, 60-61 

screen and border, 60-63, 138 



Commands, &ASIC, 114-117 
Commodore key, (see graphics keys) 
Connections 
optional, 6~7 

recir, 2-3 

aide panel, 2 

TVj'Monftor, 3-5 
CONT eommand, 114 
ConTRL key, 11, 16 
cosine functiori, 126 
CuRSoR keys, 10, 15 
Correcting errors, 3-4 
Cursor, 10 



I3ATA55ETT6 recorder, (see cassette 

tape recorder) 
Dulci, loudinij und ^uving (disk), 13-21 
(^ata, leading «nd taring (tape), 

IS-21 
DATA statement, 92-94 IT 8 
DEFine statement, 118 
Delay loop, 61 , 65 
DELete key, IS 

DIMension statement, 118-119 
Division, 23, 26, 27, 113 
Duration, [se& For . . . Next) 



Editing prograns, 15, 34 

END statement, 1 19 

Equal, not-equal-to, signs, 23, 26-27, 

114 
FquatinnR^ 1 1 4 

Error messages, 2!-!3, lJO-151 
Expansion port, 141-142 
Exponent function, 326 
Exponentiation, 25-27, 113 



Files, (DATASSETTE), 21, nO-lll 
files, (disk), £1, 110-111 
FOR statement, 1 19 
FRE fvns+ion, 129 
FuretSoni, 125-129 



Game controls ond ports, 2-3, lil 

GET statement, 47-48, 119-120 

GET* statemenr, 120 

Getting sforted, 13-29 

GOSUB statement, 120 

GOTO (GO TO) statement, 32-34, 120 



Its 



Graphic keys, 17, 56-57, 61, 132-137 
Graphic symbols, (see graphic keys) 
GreaheT tllar, I 14 

H 

Hyperbolic functions^ 14.0 

I 

IEEE-483 Interface, 2-3, 141 

IF . . . THEN stglement, 37-39, 120- 

121 
INPUT statement, 45-47, 121 
INPUT#, 121 
INScrt key, 15 
IN1«g«r functien, 126 
Int^^ger varichle, 1 15 
I/O pinouts, Ul-Ua 
I/O ports, 2-7, m-U3 



Joysticks, 2-3, 141 



Keyboard , 14-17 



LEFTS function, 128 

LEMgth function, ] 2B 

Less than, 1 14 

LEr statement, 12? 

LIST command, 33-34, 115 

LOAD command, 1 15 

LOADing programs on tape, lS-20 

LOGortthm function, 126 

Loopi, 39-4C, 43-45 

Lower co9e charcictera, 14-17 

M 

Mathematics 
fo»mulas, 23-27 
Function table, 140 
symbols, 24-27, 38, 1 U 

Memory expan*iori, 2-4, 142 

Memory maps, 62-65 

MID$ function, 128 

Modularor, RF, 4-7 

Multiplication, 24, 113 

Music, 79-90 

N 

N<3m«s 

program, 18-21 

variable, 34-37 
NEW eomtriond, 115 
NEXT statement, 121-122 



NOT operator, 1 U 
Numeric variobles, 36-37 



ON statement, 122 
OPEN statemsnt, 123 
Operators 

arittimefic, 1 13 
logical, I J4 
relational, 1 14 



Porentheses, 28 
PEEK function, <50-i52 

Ptriplieiuli, ylii, 2-8j 107-109 

POKE atotement, 6<>-6^ 

Ports, I/O, 2-3, 141-143 

POS function, 129 

PRINT 5tatem*nt, 23-29, 153-154 

PRINT#, 124 

Progroms 

editing, 15, 34 

line numbering, 32-33 

loading/saving CDATASSEHE), lB-21 

loading/saving (disk), 13-21 
Prompt, 45 



Quotalion marks, 22 

R 

RaNDom function, 48-53, 126 

Random numbers, 48-53 

READ statement, 124 

REMork statement, 124 

Re^t:rv$d words, (s^e Commend stote- 

ments) 
Restore U&y, IS, 18 
RESTORE statement, 124 
Return k»y, 15, 18 
RETURN stotement, 124 
RIGHTS function, 123 
RUN commtind, T16 
RUN/STOP key, 16-17 

S 

SAVE tommand, 21, 1 U 

Saving programs (DATASSETTE),, 21 

Saving progroms (disk), 2/ 

Screen mentory maps, 62-63, 138 

SGN, fonefion, 127 

Shift key, 14-15, 17 

SINs function, 127 

Sound effects, 89- PO 

SPC function, 129 
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SPRITE EDITOR, vii, 69-76 

SPRITE grapSies, vii, 69-?6 

SQudRe function, J 27 

STOP command, 125 

STOP key, 16-17 

String variablei, 36-37, 112-113 

STR$ function, 1 28 

Subscripted variables, 95-9S, 112-113 

Subtraction, 2-4, 113 
Syntax error, 22 
SYS statement, 125 



TAB function, !29 
TAN function, 127 
Tl variable, 1 13 
Tl* variable,, 113 
Tim& clock, 1 13 
TV conrechons, 3-7 

U 

Upp«r/Lov^«r Case mode, 1^ 



USR function, 127 

Us&r defined Function, (r&e DEf) 



ViVLje function, 123 

Variables 

array, Vj- J03, I 13 
dimensions, 98-103, 1 13 
floating point, $5-103, 113 

integer, 95-103, 112 
numeric, 95-103, 112 
j+rirg ($), 95-103, 113 

VERIFY eommond, 1 17 

\foice, eO-90, 162-16* 

w 

WAIT commcind, 125 
Wriling to tape, 1 10 



Z-80, vii, 108 
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Commodore hopes you've enjoyed the COMMODORE 64 
USER'S GUIDE. Although this manual contains some pro- 
gramming information and lips, it is NOT intended to be a 
Programmer's Reference Manual. For those of you who are 
advanced programmers end computer hobbyists Commo- 
dore suggests that you consider purchasing the COMMO- 
DORE 64 PROGRAA'\MER'S REFEKtNCE GUIDE ovailable 
through yoijr local Commodore dealer. 



Vi ndHition irpr!nt=?s and cofrectorts OS wsll as prBgiammnQ hints and tips ar& available in 
the COWMODORE end POWFR PLAY magazines, ort the COMMODORE dotabdse of the 
COMPUSERVE \HfOfLtMkl\OH NETWORIf. nccesserl thronpK n VICAAOnFM 



COMMODORE 64 QUICK terERENCX CARD 



SIMPLE VARIABLES 

rt^.1 xy = ^ .70! Ji TB3E+ ae 

^2.flaa73fa8E-39 
Infigrr ?CV^ :t 32767 

X, ii Q e-ner (A-E}. > ■» *i lErtaf c' numrber {0-^3- ■*;™at4( rhsmti 
COT be msre- ifcart 2clKix]Citn, l«/i (nly 4m frii Two cr* rtcog' 
nazed. 



iyj» 


Wum« 


ShiqEe I>im*niien 


XY(5J 


^«>-Oiri*»nj"hgn 


xvts^ 


fh'«e-Pin>Bns«n 


XYfS^.S 



Ar-flys o1^ LP fc ■[■•'eiHi e-lerrents {sutKri^i* 0-TO-) Mw be ii»ed 
wheri (veeded flrrgyi wifh riwrt Than eleven eleTiim^ n*id w 

t« DIManibnml. 
AlSEBItAIC OnRATDRS 



■^ ETpDnentinHiHi 
i QiviiiENi 
— Subtrocfcn 



< last Ihan 



<.= km Then at IquQi Tgi 

>= Creater Tior\ or Eqw^l "Te 

NOT Laglcal "iNaf" 

AMD twicol "And" 

OE Lifllc-il "Or" 

Ex:±ir>liHbi^ rqutill 1 If Jhat^ 3 \t fOlH. 

SYSTEM COMMANDS 



lCiaCj 


-WAVU:- 




SiWF^' 


WAWE" 




LOAD 


"hAME" 


'^ 


SJWE ■ 


■MAme- 


.& 


VEBlPi 


■ "NJUAE- 


RUN 






AUH ^ 


"■ 




STOP 






CH& 






CD+IT 







LCOdl a pta^rom from rope 

Sovii a pfD^ranl an 'ope 
Leodi a p*o^fom hofn liiA 

'H^rifiB* thrir fitfi^nm wnx ^A'fd 
wlth»ul CrrOfE 

EkbcuM^ pr^ji'Cihi tfttrtlfig crt 'n* 

Halt! (NiKutiein 

C^n'inuB i^r^ram baxti^\on frarr 
lift* wlier* p'ogrjm wqi hnliiJ 
Riiiii,3iia .viiiFiiia tif i"ii*-mi>rf 

Chvigei corit^nii pf Igc^'lon X 

■ L. v^IuaV 

Jvrrps td ixiMurE o machine longuv^a 

ho^ram '■Analri uiill cnn-t-ain dV 
iMoTien. X, when FO«fl'd wirh Z md 
AN[>cJ ivlih y, l] nDi*£er«. 
Paiir-i ^oluf dF .^ Id □ machine 



EblTINe AME» P011UATT!IHG frCMMAMTK 

1.1ST 
LIST A-e 

REM Mi*li:]gE 



Llii'b Entra pmOltim 
LltTi Jrorpi lire A to line B 



EPCOJ 
CLR/I^OME 
SHIFT O-H^HCME 
^IFT IHST/Da 



PRIMTs K. blanks an Une 

R^tjrni riirra-nl curior pcaitiiM 

Positions curuir 'Q lePt corner -of 

Kfflen 

CI*5M ICttn ^nd pi^CSit rmtnT i 

"Homp" paiiritsn 



CTRL W^ri ui^d vtf^h nuifflHerie. ceFcr ksy^ 

*el«TS lejT color, Wfly \ft Vlfd l» 
Pftl'ilT 9la1em#[lL 

■CRSR Kcys Wore* -curjtr wp, J^«n, l»ft, riQM 

Cb-mfflcdwe Key Wh»n uwd wit*i SH[=^ lale^it 

grc^hic dis-ploy modfe. 

Whin Uied wfth numeric CoLflr key, 

ifil^Ti qprlqtial lenr cdFcii 

UKATS H4B STRNQS 

mfVl AtJ(,1,2j Sen inEEtimiim Ubiitiji-rt ter Ai 

reserve* iiKce br rx + If (T-l)'i2^l5 
pIvFTKfnn iicninQ at f*i\fl,9,0} 
Keumi nun.bGf dT cnoroctm in ^i 

DDUHnerticd n O it'ing 

Re-hjrni nurr.pric v(]Ile of AI., Up tO 
Fl'sl -nonnii-n-er-c chi^rn^tflr 

fittjrfiB ASCJI tliarotier w'hote code 

RctkF^E Asai corf* ^r r.-tt 

cHaracTir of Xt 

fitrjfns lefll»W)H K ehcng;l»n (if ^$ 

oF Al 
WID*lAi,K,Y) RfftjrniY chc:in;rEri of AS 

a-tankng u1 tliur'ULiifr X 

FHPUT OtTPLTT COISWAANrS 

INPUT Al OH A PfiHtE '?' Qii *tfa-#h artd wc^tt iF«r 
uMf htj enter -a sirin.j ot v^lvv 
P&tJTs mtsA^t ond wcira far utef 

^Abiis fur Liier Te lyp e or^- 

chgraptir valu*, no RETURN riEe^ed 
li-i;tlaliz£i o Kt of ■'ciluek rhs+ 
can be uied by RL^.D sIsTemen) 
Assigns nenrt D^TA value ts AS a' A 

Ac?)s :^rc po-hler rn ilor1 
{^EAping thf C'^TA list a^nJA 

f ftlMTi jtlrii-g 'A= ' OAd yak« ol A 

';■ iuppeU4I. Sp9C«E - '.■ "Cihs -daTti 

«> i«jft field. 



\AL(XE) 

A£C(Hf3 

UFTS.AS.X) 
RICI-n5(AS,Xk 



INPUT ^AjC'jA 
£ET A$ □' A 

READ Mai f. 



PRINT ' 



PROGRAM FLOW 



GOTO X 

IF A=3 THEN 10 



iOft A=3 TO 10 
STEP 2 : MEXT 



MEXT A 

eosve aooo 



KEi^xn 



TAB(XJ 



\± igFuir4id during iHcaiam •*BEU1ian 

UiAd in PRIiMT }taTemen>e, 5{4ce> X 



IF a6ie.iion Is True IHftJ execute 

-^pllo-^wir-g pai-r -cf aiaVampnB. if^ 

■folve, «ecu<e rexT ine lurnaer 
EKKlJfe ull ?Jg!»mer^li b^tWiltn FOR 
uniJ LO'rc3-|K:ndiny HEX1, wHh A 
^aing from I Tr lO by 3. Slip lizv 

Ddnes vnc -qf ii^np A 11 gfntgikod 
Bronchi* le jufc^ouffie ft-ortflg «t 
llni 2C40 
IViarhb end of vjbfoutine, KrTurns To 

tidlaminl ^allDwinQ mmt r«=Bnf 

Gosue 

IJN X GOTO A,a Branchct 14 XTh liUVi rtumtw M 
lilir. I<F X :- 1 hroncUfE fit A, iHt. 

^h X GOSV& A,.Q SrnnchBi tg aubrcu-in* 3l JQh liiir 
nvnbv in GsT 



ABOUT THE COMMODORE 64 
USER'S GUIDE . . . 



Outstanding color , . . sound synthesis . . graphics . . . 
computing capabilities . , . the synergistic marriage of 
state-of-the-art teclinologies. These features make the 
Commodore 64 the most advanced personal computer 
in its class. 

The Commodore 64 User's Guide helps you get started 
in computins, even if you've never used a computer 
before. Ttirough clear, step-by-step mstructions, you 
are given an insight into the BASIC language and now 
the Commodore 64 can be put to a myriad of uses. 

For those already familiar with microcomputers, the 
advanced programming sections and appendices 
explain the enhanced features of the Commodore 64 
and how to set the most of these expanded 
capabilities. 
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